Поделиться через

Схема профиля сканирования

  • Статья

Схема профиля сканирования определяет формат XML, который можно использовать для хранения свойств элементов получения изображений Windows (WIA), таких как сканеры и камеры. Эти постоянные файлы позволяют приложениям выполнять автоматическое сканирование без необходимости запоминать параметры свойств элементов.

Любое устройство IWiaItem2 может иметь профиль сканирования. Однако элементы IWiaItem2 типов WIA_CATEGORY_FINISHED_FILE и WIA_CATEGORY_ROOT не могут иметь профили.

Профили сканирования создаются и управляются с помощью интерфейсов IScanProfile, IScanProfileMgr и IScanProfileUI . Пользователи приложения могут изменять профили ограниченными способами с помощью метода IScanProfileUI::ScanProfileDialog .

Все профили сканирования имеют следующие элементы: <ProfileGUID>, <DeviceID>, <ProfileName>, <WiaItem>, и <Properties>. Профиль устройства по умолчанию также содержит <Default> элемент .

Элемент <ProfileGUID> и <DeviceID> элемент нельзя изменить после создания профиля сканирования. Значения <ProfileName> элемента и <WiaItem> элемента могут быть изменены. Элемент <Default> можно добавить или удалить. Это можно сделать программным способом с помощью методов IScanProfile::SetName, IScanProfile::SetItem и IScanProfileMgr::SetDefault . Эти свойства также могут изменяться пользователями с помощью метода IScanProfileUI::ScanProfileDialog .

Элемент <Properties> содержит дочерние элементы <Property> . Используйте их для добавления любого элемента WIA или свойства устройства в профиль. Вы также можете развивать свой собственный образ оправдание <Property> детей. Это делает схему профиля сканирования расширяемой. (Дополнительные сведения о расширении схемы см. в разделах Определение настраиваемых свойств, IScanProfile::GetProperty и IScanProfile::SetProperty.)

Ниже приведена полная схема профиля сканирования. Ниже приведен пример профиля.

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

Щелкните Показать пример , чтобы просмотреть пример профиля.

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

Reference

IScanProfile::GetProperty

IScanProfile::SetProperty

Основные понятия

Константы свойств WIA

Определение пользовательских свойств