Schema del profilo di analisi

  • Articolo

Lo schema del profilo di analisi definisce un formato XML che può essere usato per archiviare le proprietà degli elementi di Acquisizione immagini di Windows , ad esempio scanner e fotocamere. Questi file persistenti consentono alle applicazioni di fornire analisi automatica senza richiedere agli utenti di ricordare le impostazioni delle proprietà degli elementi.

Qualsiasi dispositivo IWiaItem2 può avere un profilo di analisi. Tuttavia, gli elementi IWiaItem2 di tipi WIA_CATEGORY_FINISHED_FILE e WIA_CATEGORY_ROOT non possono avere profili.

I profili di analisi vengono creati e gestiti tramite le interfacce IScanProfile, IScanProfileMgr e IScanProfileUI. Gli utenti dell'applicazione possono modificare i profili in modi limitati usando il metodo IScanProfileUI::ScanProfileDialog .

Tutti i profili di analisi hanno gli elementi seguenti: <ProfileGUID>, <DeviceID>, <ProfileName>, <WiaItem>e <Properties>. Il profilo predefinito di un dispositivo ha anche un <Default> elemento.

L'elemento <ProfileGUID> e l'elemento <DeviceID> non possono essere modificati dopo la creazione del profilo di analisi. I valori dell'elemento e dell'elemento <ProfileName><WiaItem> possono essere modificati. L'elemento <Default> può essere aggiunto o eliminato. Questa operazione può essere eseguita in modo programmato usando i metodi IScanProfile::SetName, IScanProfile::SetItem e IScanProfileMgr::SetDefault. Queste proprietà possono essere modificate anche dagli utenti tramite il metodo IScanProfileUI::ScanProfileDialog .

L'elemento <Properties> contiene <Property> elementi figlio. Usare queste proprietà per aggiungere qualsiasi elemento o proprietà del dispositivo WIA al profilo. Puoi anche sviluppare i tuoi figli di acquistion <Property> di immagini. Ciò rende estendibile lo schema del profilo di analisi. Per altre informazioni sull'estensione dello schema, vedere Definizione di proprietà personalizzate, IScanProfile::GetProperty e IScanProfile::SetProperty.

Ecco lo schema completo del profilo di analisi. Segue un profilo di esempio.

<?xml version="1.0"?>
<xs:schema xmlns:xs="https://www.w3.org/2001/XMLSchema"
            targetNamespace="https://www.microsoft.com"
            xmlns="https://www.microsoft.com"
            elementFormDefault="qualified">

<xs:element name="ScanProfile">
            <xs:complexType>
            <xs:sequence>
                        <xs:element name="ProfileGUID" type="xs:string"/>
                        <xs:element name="DeviceID" type="xs:string"/>
<xs:element name="ProfileName" type="xs:string"/>
                        <xs:element name="Default" minOccurs="0">
                                    <xs:complexType>
                                    </xs:complexType>
                        </xs:element>
                        <xs:element name="WiaItem" type="xs:string"/>
                        <xs:element name="Properties" type="Properties"/>
            </xs:sequence>
            </xs:complexType>
</xs:element>
 
<xs:complexType name="Properties">
<xs:sequence>
            <xs:element name="Property" maxOccurs="unbounded" minOccurs="0">
            <xs:complexType>
            <xs:simpleContent>
                        <xs:extension base="xs:string">
                                    <xs:attribute name="id" type="xs:integer" use="required"/>
                                    <xs:attribute name="type" type="xs:integer" use="required"/>
                        </xs:extension>
            </xs:simpleContent>
            </xs:complexType>
            </xs:element>
</xs:sequence>
</xs:complexType>
 
</xs:schema>

Fare clic su Mostra esempio per visualizzare un profilo di esempio.

<ScanProfile>
    <ProfileGUID>
        {F862E217-32B0-4396-987A-2191224925CD}
    </ProfileGUID>
    <DeviceID>
        {6BDD1FC6-810F-11D0-BEC7-08002BE2092F}\0001
    </DeviceID>
    <ProfileName>
        Last used settings
    </ProfileName>
    <WiaItem>
        {FB607B1F-43F3-488B-855B-FB703EC342A6}
    </WiaItem>
    <Properties>
        <Property id="4103" type="3">
            3
        </Property>
        <Property id="4106" type="72">
            {B96B3CAB-0728-11D3-9D7B-0000F81EF32E}
        </Property>
        <Property id="6147" type="3">
            300
        </Property>
        <Property id="6154" type="3">
            0
        </Property>
        <Property id="6155" type="3">
            0
        </Property>
    </Properties>
</ScanProfile>

Riferimento

IScanProfile::GetProperty

IScanProfile::SetProperty

Informazioni concettuali

Costanti delle proprietà WIA

Definizione delle proprietà personalizzate