Définition de propriétés personnalisées

S’il est nécessaire que le minidriver WIA définisse des propriétés personnalisées, la propriété WIA_PRIVATE_DEVPROP doit être utilisée pour les propriétés d’élément racine personnalisées, et la propriété WIA_PRIVATE_ITEMPROP doit être utilisée pour d’autres propriétés d’élément. Ces constantes sont définies dans wiadef.h.

L’exemple de code suivant montre les définitions de trois propriétés d’élément racine. L’ID de propriété de la première propriété d’élément racine personnalisée, CUSTOM_ROOT_PROP_1, est défini en termes de WIA_PRIVATE_DEVPROP. Les ID de propriété pour les propriétés d’élément racine supplémentaires sont définis en termes de WIA_PRIVATE_DEVPROP + 1, WIA_PRIVATE_DEVPROP + 2, etc. Le modèle peut être poursuivi si des propriétés d’élément racine personnalisées supplémentaires sont nécessaires.

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

L’exemple suivant montre les définitions de trois propriétés d’élément enfant personnalisées et des ID de propriété. L’ID de propriété de la première propriété d’élément enfant personnalisée, CUSTOM_CHILD_PROP_1, est défini en termes de WIA_PRIVATE_ITEMPROP. Les ID de propriété pour les propriétés d’élément enfant supplémentaires sont définis en termes de WIA_PRIVATE_ITEMPROP + 1, etc. Comme précédemment, le modèle peut être poursuivi si davantage de ces propriétés d’élément enfant personnalisées sont nécessaires.

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

Les propriétés WIA personnalisées doivent avoir des noms de propriétés personnalisés qui sont associés aux ID de propriété personnalisée. L’exemple de code suivant montre les définitions de trois noms de propriétés d’élément racine personnalisés. (Ces noms de propriétés sont utilisés avec les ID de propriété personnalisés créés dans un exemple précédent, où le nom de propriété personnalisé contenu dans CUSTOM_ROOT_PROP_1_STR est associé à l’ID de propriété d’élément racine personnalisé 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"

Note Les noms de propriétés WIA ne sont pas localisés dans plusieurs langues. En effet, les propriétés WIA peuvent être lues par les applications à l’aide de l’ID de propriété ou du nom de la propriété. Si le nom est utilisé, il doit s’agir d’une constante, tout comme l’ID de propriété.