WIA_IPS_XEXTENT

Artigo
06/15/2023

A propriedade WIA_IPS_XEXTENT contém a largura atual, em pixels, de uma imagem selecionada a ser adquirida.

Tipo de propriedade: VT_I4

Valores válidos: WIA_PROP_RANGE

Direitos de acesso: leitura/gravação

Comentários

Um aplicativo define a propriedade WIA_IPS_XEXTENT para marcar o canto superior esquerdo (ou seja, a largura) da área de seleção a ser adquirida. O minidriver cria e mantém essa propriedade.

WIA_IPS_XEXTENT é necessário para todos os itens habilitados para aquisição de imagem e itens filho desses itens; esta propriedade não está disponível para itens de armazenamento ou itens de imagem armazenados.

Quando um tamanho de página fixo é definido, o driver precisa definir as propriedades WIA_IPS_XEXTENT, WIA_IPS_XPOS, WIA_IPS_YEXTENT e WIA_IPS_YPOS para corresponder às dimensões de tamanho de página e uma origem "0". Para o alinhamento do documento central, o driver precisa definir WIA_IPS_XPOS como ((largura da área de verificação - largura do documento) / 2) * resolução [DPI]) e WIA_IPS_YPOS para ((altura da área de verificação - altura do documento) / 2) * resolução [DPI]).

Quando a origem ou uma extensão é alterada, o driver precisa atualizar a propriedade WIA_IPS_PAGE_SIZE para CUSTOM_SIZE e as propriedades WIA_IPS_PAGE_WIDTH e WIA_IPS_PAGE_HEIGHT para corresponder às extensões da área de verificação. A orientação e a rotação não devem afetar essas propriedades, a menos que uma alteração de orientação (não uma alteração de rotação) renderize a origem ou uma extensão fora da área de verificação de documento disponível.

Um driver também deve atualizar as propriedades WIA_IPS_XEXTENT, WIA_IPS_XPOS, WIA_IPS_YEXTENT e WIA_IPS_YPOS quando WIA_IPS_XRES e WIA_IPS_YRES são alterados.

Nota Os itens filho Flatbed e Film devem dar suporte apenas às propriedades WIA_IPS_XEXTENT, WIA_IPS_XPOS, WIA_IPS_XRES, WIA_IPS_YEXTENT, WIA_IPS_YPOS e WIA_IPS_YRES. Todas as outras propriedades, obrigatórias ou opcionais para seus pais (os itens base Flatbed ou Film), são opcionais apenas para esses itens. As únicas exceções são as propriedades WIA_IPA_ITEM_Xxx , que são necessárias para todos os itens.