Definizione delle proprietà personalizzate

Definizione delle proprietà personalizzate.

Se è necessario per il minidriver Windows Image Acquisition (WIA) definire le proprietà personalizzate, la proprietà WIA_PRIVATE_DEVPROP deve essere usata per le proprietà dell'elemento radice personalizzate e la proprietà WIA_PRIVATE_ITEMPROP" deve essere usata per altre proprietà dell'elemento. Queste costanti sono definite in wiadef.h.

Il codice di esempio seguente mostra le definizioni per tre proprietà dell'elemento radice. L'ID proprietà per la prima proprietà dell'elemento radice personalizzato, CUSTOM_ROOT_PROP_1, viene definita in termini di WIA_PRIVATE_DEVPROP. Gli ID proprietà per le proprietà dell'elemento radice aggiuntivi sono definiti in termini di WIA_PRIVATE_DEVPROP + 1, WIA_PRIVATE_DEVPROP + 2 e così via. Il modello può essere continuato se sono necessarie altre proprietà dell'elemento radice personalizzate.

#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'esempio successivo mostra le definizioni per tre proprietà e ID proprietà figlio personalizzati. L'ID proprietà per la prima proprietà dell'elemento figlio personalizzato, CUSTOM_CHILD_PROP_1, viene definita in termini di WIA_PRIVATE_ITEMPROP. Gli ID proprietà per le proprietà degli elementi figlio aggiuntivi sono definiti in termini di WIA_PRIVATE_ITEMPROP + 1 e così via. Come prima, il modello può essere continuato se sono necessarie altre proprietà dell'elemento figlio personalizzate.

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

Le proprietà WIA personalizzate devono avere nomi di proprietà personalizzati associati agli ID delle proprietà personalizzate. Il codice di esempio seguente mostra le definizioni per tre nomi di proprietà dell'elemento radice personalizzati. Questi nomi di proprietà vengono usati con gli ID proprietà personalizzati creati in un esempio precedente, in cui il nome della proprietà personalizzato contenuto in CUSTOM_ROOT_PROP_1_STR è associato all'ID proprietà radice personalizzato 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"

Nota

I nomi delle proprietà WIA non vengono localizzati in più lingue. Ciò avviee perché le proprietà WIA possono essere lette dalle applicazioni usando l'ID proprietà o il nome della proprietà. Se viene usato il nome, deve essere una costante, proprio come l'ID proprietà è.