Definindo propriedades personalizadas

Definindo propriedades personalizadas.

Se for necessário que o minidriver wia (aquisição de imagens do Windows) defina propriedades personalizadas, a propriedade WIA_PRIVATE_DEVPROP deve ser usada para propriedades de item raiz personalizadas e a propriedade WIA_PRIVATE_ITEMPROP" deve ser usada para outras propriedades de item. Essas constantes são definidas em wiadef.h.

O código de exemplo a seguir mostra definições para três propriedades de item raiz. A ID da propriedade da primeira propriedade de item raiz personalizada, CUSTOM_ROOT_PROP_1, é definida em termos de WIA_PRIVATE_DEVPROP. As IDs de propriedade para propriedades de item raiz adicionais são definidas em termos de WIA_PRIVATE_DEVPROP + 1, WIA_PRIVATE_DEVPROP + 2 e assim por diante. O padrão poderá ser continuado se forem necessárias propriedades de item raiz personalizadas adicionais.

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

O próximo exemplo mostra definições para três propriedades de item filho personalizadas e IDs de propriedade. A ID da propriedade do primeiro item filho personalizado, CUSTOM_CHILD_PROP_1, é definida em termos de WIA_PRIVATE_ITEMPROP. As IDs de propriedade para propriedades de item filho adicionais são definidas em termos de WIA_PRIVATE_ITEMPROP + 1 e assim por diante. Como antes, o padrão poderá ser continuado se mais dessas propriedades de item filho personalizadas forem necessárias.

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

As propriedades wia personalizadas devem ter nomes de propriedade personalizados associados às IDs de propriedade personalizadas. O código de exemplo a seguir mostra definições para três nomes de propriedade de item raiz personalizados. (Esses nomes de propriedade são usados com as IDs de propriedade personalizada que foram criadas em um exemplo anterior, em que o nome da propriedade personalizada contido em CUSTOM_ROOT_PROP_1_STR está associado à ID da propriedade de item raiz personalizada 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"

Observação

Os nomes de propriedade wia não são localizados em vários idiomas. Isso ocorre porque as propriedades wia podem ser lidas por aplicativos usando a ID da propriedade ou o nome da propriedade. Se o nome for usado, ele deverá ser uma constante, assim como a ID da propriedade é.