Определение пользовательских свойств
Определение пользовательских свойств.
Если мини-диск windows Image Acquisition (WIA) должен определять пользовательские свойства, свойство WIA_PRIVATE_DEVPROP должно использоваться для пользовательских свойств корневого элемента, а свойство WIA_PRIVATE_ITEMPROP" — для других свойств элементов. Эти константы определяются в файле wiadef.h.
В следующем примере кода показаны определения для трех свойств корневого элемента. Идентификатор свойства для первого настраиваемого свойства корневого элемента, CUSTOM_ROOT_PROP_1, определяется с точки зрения WIA_PRIVATE_DEVPROP. Идентификаторы свойств для дополнительных свойств корневого элемента определяются в терминах WIA_PRIVATE_DEVPROP + 1, WIA_PRIVATE_DEVPROP + 2 и т. д. Шаблон можно продолжить, если требуются дополнительные пользовательские свойства корневого элемента.
#define CUSTOM_ROOT_PROP_1 WIA_PRIVATE_DEVPROP
#define CUSTOM_ROOT_PROP_2 (WIA_PRIVATE_DEVPROP + 1)
#define CUSTOM_ROOT_PROP_3 (WIA_PRIVATE_DEVPROP + 2)
В следующем примере показаны определения для трех настраиваемых свойств и идентификаторов свойств дочерних элементов. Идентификатор свойства для первого настраиваемого свойства дочернего элемента, CUSTOM_CHILD_PROP_1, определяется в терминах WIA_PRIVATE_ITEMPROP. Идентификаторы свойств для дополнительных свойств дочерних элементов определяются в терминах WIA_PRIVATE_ITEMPROP + 1 и т. д. Как и ранее, шаблон можно продолжить, если требуется больше этих настраиваемых свойств дочернего элемента.
#define CUSTOM_CHILD_PROP_1 WIA_PRIVATE_ITEMPROP
#define CUSTOM_CHILD_PROP_2 (WIA_PRIVATE_ITEMPROP + 1)
#define CUSTOM_CHILD_PROP_3 (WIA_PRIVATE_ITEMPROP + 2)
Пользовательские свойства WIA должны иметь пользовательские имена свойств, связанные с идентификаторами настраиваемых свойств. В следующем примере кода показаны определения для трех пользовательских имен свойств корневого элемента. (Эти имена свойств используются с идентификаторами пользовательских свойств, созданными в предыдущем примере, где имя настраиваемого свойства, содержащееся в CUSTOM_ROOT_PROP_1_STR, связано с идентификатором свойства пользовательского корневого элемента CUSTOM_ROOT_PROP_1.)
#define CUSTOM_ROOT_PROP_1_STR L"My First Custom Root Item Property"
#define CUSTOM_ROOT_PROP_2_STR L"My Second Custom Root Item Property"
#define CUSTOM_ROOT_PROP_3_STR L"My Third Custom Root Item Property"
Примечание
Имена свойств WIA не локализованы на нескольких языках. Это связано с тем, что приложения могут считывать свойства WIA с помощью идентификатора свойства или имени свойства. Если используется имя, оно должно быть константой так же, как и идентификатор свойства.