Freigeben über

Scanprofilschema

  • Artikel

Das Scanprofilschema definiert ein XML-Format, das zum Speichern der Eigenschaften von WIA-Elementen (Windows-Bilderfassung) wie Scannern und Kameras verwendet werden kann. Diese persistenten Dateien ermöglichen Es Anwendungen, automatische Überprüfungen bereitzustellen, ohne dass benutzer sich die Eigenschafteneinstellungen der Elemente merken müssen.

Jedes IWiaItem2-Gerät kann über ein Scanprofil verfügen. IWiaItem2-Elemente von Typen WIA_CATEGORY_FINISHED_FILE und WIA_CATEGORY_ROOT können jedoch keine Profile aufweisen.

Scanprofile werden über die Schnittstellen IScanProfile, IScanProfileMgr und IScanProfileUI erstellt und verwaltet. Benutzer Ihrer Anwendung können Profile mit der IScanProfileUI::ScanProfileDialog-Methode auf begrenzte Weise ändern.

Alle Überprüfungsprofile verfügen über die folgenden Elemente: <ProfileGUID>, <DeviceID>, <ProfileName>, <WiaItem>, und <Properties>. Das Standardprofil eines Geräts verfügt ebenfalls über ein <Default> -Element.

Das <ProfileGUID> Element und das <DeviceID> Element können nicht geändert werden, nachdem das Überprüfungsprofil erstellt wurde. Die Werte des <ProfileName> Elements und des <WiaItem> Elements können geändert werden. Das <Default> Element kann hinzugefügt oder gelöscht werden. Dies kann programmgesteuert mithilfe der Methoden IScanProfile::SetName, IScanProfile::SetItem und IScanProfileMgr::SetDefault erfolgen. Diese Eigenschaften können von Benutzern auch über die IScanProfileUI::ScanProfileDialog-Methode geändert werden.

Das <Properties> -Element enthält <Property> untergeordnete Elemente. Verwenden Sie diese, um dem Profil ein beliebiges WIA-Element oder eine Geräteeigenschaft hinzuzufügen. Sie können auch Ihr eigenes Image übernehmen Kinder <Property> . Dadurch ist das Scanprofilschema erweiterbar. (Weitere Informationen zum Erweitern des Schemas finden Sie unter Definieren von benutzerdefinierten Eigenschaften, IScanProfile::GetProperty und IScanProfile::SetProperty.)

Hier sehen Sie das vollständige Scanprofilschema. Es folgt ein Beispielprofil.

<?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>

Klicken Sie auf Beispiel anzeigen , um ein Beispielprofil anzuzeigen.

<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>

Referenz

IScanProfile::GetProperty

IScanProfile::SetProperty

Konzept

WIA-Eigenschaftskonstanten

Definieren benutzerdefinierter Eigenschaften