WIA_DPS_PAGE_SIZE
A propriedade WIA_DPS_PAGE_SIZE contém o tamanho da página que está selecionada para ser verificada no momento.
Tipo de propriedade: VT_I4
Valores válidos: WIA_PROP_LIST
Direitos de acesso: leitura/gravação
Comentários
Para selecionar as dimensões da página a ser digitalizada, um aplicativo define WIA_DPS_PAGE_SIZE. O minidriver WIA cria e mantém essa propriedade.
A tabela a seguir descreve as constantes válidas com WIA_IPS_PAGE_SIZE.
Valor | Definição |
---|---|
WIA_PAGE_A4 | O tamanho da página é 8267 × 11692 (orientação PORTRAIT). |
WIA_PAGE_CUSTOM | O tamanho da página é definido pelos valores das propriedades WIA_DPS_PAGE_HEIGHT e WIA_DPS_PAGE_WIDTH . |
WIA_PAGE_LETTER | O tamanho da página é 8500 × 11000 (orientação PORTRAIT). |
O valor da propriedade WIA_IPS_ORIENTATION determina a orientação da página selecionada no momento. As propriedades WIA_DPS_PAGE_WIDTH e WIA_DPS_PAGE_HEIGHT relatam as dimensões da página, em milésimos de polegada (0,001). Essas propriedades devem ter valores equivalentes às propriedades WIA_IPS_XEXTENT e WIA_IPS_YEXTENT , que contêm as dimensões da página, em pixels.
WIA_PROP_LIST valores tipado devem depender de configurações válidas da propriedade WIA_IPS_ORIENTATION. Se um dispositivo não puder examinar documentos orientados à paisagem com uma configuração de WIA_PAGE_A4, WIA_PAGE_A4 não deverá aparecer na lista de valores válidos para a propriedade WIA_DPS_PAGE_SIZE quando WIA_IPS_ORIENTATION estiver definido como LANDSCAPE.
Se um aplicativo definir WIA_DPS_PAGE_SIZE para qualquer valor diferente de WIA_PAGE_CUSTOM, o minidriver deverá ajustar os valores de WIA_DPS_PAGE_WIDTH e WIA_DPS_PAGE_HEIGHT para as dimensões da página, em milésimos de polegada (0,001). O minidriver também deve ajustar os valores de WIA_IPS_XEXTENT e WIA_IPS_YEXTENT para as dimensões da página, em pixels.
Se uma configuração de extensão (WIA_IPS_XEXTENT ou WIA_IPS_YEXTENT) for alterada para um valor que não corresponda à configuração de tamanho de página atual, o minidriver deverá alterar o valor da propriedade WIA_DPS_PAGE_SIZE para WIA_PAGE_CUSTOM. O minidriver também deve modificar WIA_DPS_PAGE_WIDTH ou WIA_DPS_PAGE_HEIGHT de acordo com a configuração de nova extensão.
Se WIA_IPS_ORIENTATION for definido como LANDSCAPE, as configurações de extensão serão "invertidas". Por exemplo, se um aplicativo definir WIA_DPS_PAGE_SIZE como WIA_PAGE_A4, o minidriver deverá definir WIA_DPS_PAGE_WIDTH como 11692 e WIA_DPS_PAGE_HEIGHT como 8267. (O minidriver também deve definir WIA_IPS_XEXTENT e WIA_IPS_YEXTENT adequadamente.) Observe que, se WIA_DPS_PAGE_SIZE estiver definido como WIA_PAGE_CUSTOM, a configuração de orientação não será usada para determinar as dimensões de extensão da página a ser verificada.
O minidriver deve garantir que a propriedade WIA_IPS_ORIENTATION concorde com a área de seleção atual. Se um aplicativo alterar o valor de WIA_IPS_ORIENTATION para um que seja inválido para o tamanho da página selecionado no momento, o minidriver deverá alterar o valor de WIA_DPS_PAGE_SIZE para um tamanho de página compatível com o novo valor de orientação.
Se um aplicativo definir a propriedade WIA_DPS_PAGE_SIZE como WIA_PAGE_CUSTOM, a área de seleção atual não será afetada. O minidriver WIA deve obter o layout da imagem atual, começando pelas configurações atuais das propriedades WIA_IPS_XPOS e WIA_IPS_YPOS . Se a configuração de tamanho de página resultar em uma área de seleção que esteja fora da cama do scanner, o minidriver deverá ajustar automaticamente os valores do WIA_IPS_XPOS e WIA_IPS_YPOS propriedades para configurações válidas. Se as propriedades WIA_DPS_PAGE_SIZE e WIA_IPS_ORIENTATION forem definidas ao mesmo tempo e forem inválidas quando forem aplicadas em combinação, o minidriver deverá falhar nas configurações do aplicativo retornando um erro no método IWiaMiniDrv::d rvValidateItemProperties .
Os quatro exemplos de código a seguir mostram os seguintes cenários de WIA_DPS_PAGE_SIZE:
O driver relata as configurações.
Um aplicativo define a propriedade WIA_DPS_PAGE_SIZE como WIA_PAGE_LETTER.
Um aplicativo define a propriedade WIA_IPS_ORIENTATION como LANDSCAPE.
Um aplicativo altera a propriedade WIA_IPS_XEXTENT para um valor menor.
Exemplo 1: o minidriver relata as configurações
No exemplo de código a seguir, o minidriver define uma área de seleção personalizada antes que um aplicativo defina as propriedades wia. Nesse caso, a área de seleção representa todo o flatbed.
WIA_DPS_PAGE_SIZE = WIA_PAGE_CUSTOM WIA_DPS_PAGE_WIDTH = 11500 WIA_DPS_PAGE_HEIGHT = 14.000 WIA_IPS_ORIENTATION = WIA_IPS_XPOS RETRATO = 0 WIA_IPS_YPOS = 0 WIA_IPS_XEXTENT = 1150 WIA_IPS_YEXTENT = 1400 WIA_IPS_XRES = 100 WIA_IPS_YRES = 100
Exemplo 2: um aplicativo define a propriedade WIA_DPS_PAGE_SIZE como WIA_PAGE_LETTER
WIA_DPS_PAGE_SIZE = WIA_PAGE_LETTER WIA_DPS_PAGE_WIDTH = 8500 WIA_DPS_PAGE_HEIGHT = 11.000 WIA_IPS_ORIENTATION = WIA_IPS_XPOS RETRATO = 0 WIA_IPS_YPOS = 0 WIA_IPS_XEXTENT = 850 WIA_IPS_YEXTENT = 1100 WIA_IPS_XRES = 100 WIA_IPS_YRES = 100
Exemplo 3: um aplicativo define a propriedade WIA_IPS_ORIENTATION como LANDSCAPE
A cama física deve ser capaz de adquirir uma página que estava originalmente em orientação paisagem.
WIA_DPS_PAGE_SIZE = WIA_PAGE_LETTER WIA_DPS_PAGE_HEIGHT = 11000 WIA_DPS_PAGE_WIDTH = 8500 WIA_IPS_ORIENTATION = LANDSCAPE WIA_IPS_XPOS = 0 WIA_IPS_YPOS = 0 WIA_IPS_XEXTENT = 1100 WIA_IPS_YEXTENT = 850 WIA_IPS_XRES = 100 WIA_IPS_YRES = 100
Exemplo 4: um aplicativo altera a propriedade WIA_IPS_XEXTENT para um valor menor
No exemplo de código a seguir, um aplicativo altera a propriedade WIA_IPS_XEXTENT para 1000. O minidriver deve assumir que o novo valor para WIA_IPS_XEXTENT não é mais válido para a propriedade WIA_DPS_PAGE_SIZE e, portanto, deve alterar WIA_DPS_PAGE_SIZE para WIA_PAGE_CUSTOM. O minidriver também deve ajustar WIA_DPS_PAGE_WIDTH.
WIA_DPS_PAGE_SIZE = WIA_PAGE_CUSTOM WIA_DPS_PAGE_HEIGHT = 10000 WIA_DPS_PAGE_WIDTH = 8500 WIA_IPS_ORIENTATION = LANDSCAPE WIA_IPS_XPOS = 0 WIA_IPS_YPOS = 0 WIA_IPS_XEXTENT = 1000 WIA_IPS_YEXTENT = 850 WIA_IPS_XRES = 100 WIA_IPS_YRES = 100
Requisitos
Versão: Obsoleto, use a propriedade WIA_IPS_PAGE_SIZE.
Cabeçalho: wiadef.h (inclua Wiadef.h)