Symbian3/SDK/Source/GUID-E6B3E575-80E3-58E3-9950-E0A5F6798861.dita
changeset 0 89d6a7a84779
--- /dev/null	Thu Jan 01 00:00:00 1970 +0000
+++ b/Symbian3/SDK/Source/GUID-E6B3E575-80E3-58E3-9950-E0A5F6798861.dita	Thu Jan 21 18:18:20 2010 +0000
@@ -0,0 +1,56 @@
+<?xml version="1.0" encoding="utf-8"?>
+<!-- Copyright (c) 2007-2010 Nokia Corporation and/or its subsidiary(-ies) All rights reserved. -->
+<!-- This component and the accompanying materials are made available under the terms of the License 
+"Eclipse Public License v1.0" which accompanies this distribution, 
+and is available at the URL "http://www.eclipse.org/legal/epl-v10.html". -->
+<!-- Initial Contributors:
+    Nokia Corporation - initial contribution.
+Contributors: 
+-->
+<!DOCTYPE concept
+  PUBLIC "-//OASIS//DTD DITA Concept//EN" "concept.dtd">
+<concept id="GUID-E6B3E575-80E3-58E3-9950-E0A5F6798861" xml:lang="en"><title> Using
+the Parser Plug-in Resource File</title><prolog><metadata><keywords/></metadata></prolog><conbody>
+<p>This section explains how to specify the field values for a parser plug-in
+resource file. </p>
+<section><title>Procedure</title> <p>The XML framework is designed to manage
+numerous parser implementations and has functionality to choose the implementation
+most suited to the current document. </p> <p>The criteria used to make the
+selection are held in the <xref href="GUID-54A442BD-FCF1-31D3-BEF7-598C1820F473.dita#GUID-54A442BD-FCF1-31D3-BEF7-598C1820F473/GUID-AEFF2DB4-FBC2-36EE-A4CE-7EBBD4AF004E"><apiname>Xml::CMatchData</apiname></xref> class. When this
+information does not force the selection of exactly one parser, the framework
+defaults firstly to choose a Symbian-supplied parser if present, else it will
+choose the one with the lowest UID. When a parser implementation is created,
+a resource file which supplies the related information must also be created. </p> <p>The <codeph>implementation_uid</codeph> field
+must contain the <codeph>UID</codeph> of the plug-in. The <codeph>default_data</codeph> field
+must contain the document type it can parse. The <codeph>opaque_data </codeph> field
+specifies the supplier (Symbian or other). The following is a sample resource
+file: </p> <codeblock id="GUID-2661506B-5B2F-50CF-A908-EAAE9B6EF726" xml:space="preserve">
+RESOURCE REGISTRY_INFO validatorInfo
+       {
+       dll_uid = 0x10273863;
+       interfaces = 
+              {
+              INTERFACE_INFO
+                     {
+                     interface_uid = 0x101FAA0B;
+                     implementations = 
+                            {
+                            IMPLEMENTATION_INFO
+                                   {
+                                   implementation_uid = 0x10273864;
+                                   version_no = 2;
+                                   display_name = "Example parser";
+                                   default_data = "text/xml||text/wbxml";
+                                   opaque_data = "LicenseeX";
+                                   }
+                            };
+                     }
+              };
+       }
+</codeblock> <p>For more details on how to write a sample registration resource
+file, refer to <xref href="GUID-9A9103E4-27B0-5CF3-855A-DCD44795A5C0.dita">Creating
+a Standard Registration Resource File</xref> </p> </section>
+</conbody><related-links>
+<link href="GUID-F79E4F18-19E2-577E-8409-8B82BD48AC66.dita"><linktext>XML Framework
+Overview</linktext></link>
+</related-links></concept>
\ No newline at end of file