Nota
O acesso a esta página requer autorização. Podes tentar iniciar sessão ou mudar de diretório.
O acesso a esta página requer autorização. Podes tentar mudar de diretório.
A propriedade WIA_DPS_PAGE_SIZE contém o tamanho da página que está atualmente selecionada para ser verificada.
Tipo de Propriedade: VT_I4
Valores válidos: WIA_PROP_LIST
Direitos de acesso: leitura/escrita
Observações
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 (.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 digitados devem depender de configurações válidas da propriedade WIA_IPS_ORIENTATION. Se um dispositivo não puder digitalizar documentos orientados a paisagem com uma configuração 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 deve 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 (.001). O minidriver também deve ajustar os valores de WIA_IPS_XEXTENT e WIA_IPS_YEXTENT às 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 atual de tamanho de página, 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 nova configuração de extensão.
Se WIA_IPS_ORIENTATION estiver 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 de acordo.) 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 esteja de acordo com a área de seleção atual. Se um aplicativo alterar o valor de WIA_IPS_ORIENTATION para um que é inválido para o tamanho de página selecionado no momento, o minidriver deve alterar o valor de WIA_DPS_PAGE_SIZE para um tamanho de página que é suportado pelo 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 de imagem atual, a partir das 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 fora da cama do scanner, o minidriver deverá ajustar automaticamente os valores das propriedades WIA_IPS_XPOS e WIA_IPS_YPOS 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 WIA_DPS_PAGE_SIZE cenários:
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 de um aplicativo definir quaisquer propriedades WIA. Neste caso, a área de seleção representa toda a cama plana.
WIA_DPS_PAGE_SIZE = WIA_PAGE_CUSTOM WIA_DPS_PAGE_WIDTH = 11500 WIA_DPS_PAGE_HEIGHT = 14000 WIA_IPS_ORIENTATION = RETRATO WIA_IPS_XPOS = 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 = 11000 WIA_IPS_ORIENTATION = RETRATO WIA_IPS_XPOS = 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 = PAISAGEM 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 mudar 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 = PAISAGEM WIA_IPS_XPOS = 0 WIA_IPS_YPOS = 0 WIA_IPS_XEXTENT = 1000 WIA_IPS_YEXTENT = 850 WIA_IPS_XRES = 100 WIA_IPS_YRES = 100
Requerimentos
Versão: Obsoleto, use a propriedade WIA_IPS_PAGE_SIZE em vez disso.
Cabeçalho: wiadef.h (incluir Wiadef.h)