Интерфейс IScanProfile
Интерфейс IScanProfile представляет один профиль сканирования и позволяет приложениям задавать и получать свойства профиля.
Элементы
Интерфейс IScanProfile наследуется от интерфейса IDispatch . IScanProfile также имеет следующие типы членов:
Методы
Интерфейс IScanProfile содержит следующие методы.
| Метод | Описание |
|---|---|
| GetAllPropIDs | Возвращает все доступные идентификаторы свойств в профиле. |
| GetDeviceID | Возвращает идентификатор устройства. |
| GetGUID | Возвращает GUID профиля. |
| Getitem | Возвращает GUID категории элемента WIA 2.0, с которым связан профиль. |
| GetName | Возвращает понятное имя профиля. |
| GetNumPropIDS | Возвращает количество идентификаторов свойств в профиле. |
| Getproperty | Возвращает значение указанных дочерних свойств в элементе <Properties> профиля сканирования. |
| IsDefault | Возвращает значение, указывающее, является ли профиль профилем сканирования по умолчанию для связанного устройства IWiaItem2 . |
| RemoveProperty | Удаляет указанный список дочерних свойств в элементе <Properties> профиля сканирования. |
| Сохранить | Сохраняет изменения профиля на диске. |
| SetItem | Задает GUID категории элемента WIA 2.0, с которым связан профиль. |
| SetName | Задает понятное имя профиля. |
| Setproperty | Задает значение указанных дочерних свойств в элементе <Properties> профиля сканирования. |
Комментарии
Любое устройство IWiaItem2 может иметь профиль сканирования. Однако элементы IWiaItem2 типов WIA_CATEGORY_FINISHED_FILE и WIA_CATEGORY_ROOT не могут иметь профили.
Если профиль сканирования сохраняется с помощью метода IScanProfile::Save , он сохраняется в виде XML-файла в папке %USERPROFILE%\Application Data\Microsoft\Document Center\UserScanProfiles.
Чтобы создать экземпляр объекта IScanProfile , используйте метод IScanProfileMgr::CreateProfile . Чтобы получить ссылку на профиль сканирования, который уже был сохранен на диске, используйте метод IScanProfileMgr::OpenProfile .
Все профили сканирования имеют следующие элементы: <ProfileGUID>, <DeviceID>, <ProfileName>, <WiaItem>и <Properties>. Профиль устройства по умолчанию также содержит <Default> элемент .
Элементы <ProfileGUID> и <DeviceID> нельзя изменить после создания профиля. Значения <ProfileName> элемента и <WiaItem> элемента можно изменить после создания профиля. Элемент <Default> можно добавить или удалить. Это можно сделать программно с помощью методов IScanProfile::SetName, IScanProfile::SetItem и IScanProfileMgr::SetDefault . Эти свойства также могут быть изменены пользователями с помощью метода IScanProfileUI::ScanProfileDialog .
Элемент <Properties> содержит дочерние элементы <Property> . Используйте их, чтобы добавить в профиль любой элемент или свойство устройства WIA 2.0. Вы также можете разработать собственные дочерние элементы, чтобы получить доступ к изображениям <Property> . Это делает схему профиля сканирования расширяемой. (Дополнительные сведения о расширении схемы см. в разделах Определение настраиваемых свойств, IScanProfile::GetProperty и IScanProfile::SetProperty.)
Требования
| Требование | Значение |
|---|---|
| Минимальная версия клиента |
Windows Vista [только классические приложения] |
| Минимальная версия сервера |
Windows Server 2008 [только классические приложения] |
| IDL |
|
См. также раздел