WIA_DPS_PAGE_SIZE
La propiedad WIA_DPS_PAGE_SIZE contiene el tamaño de la página que está seleccionada actualmente para examinarse.
Tipo de propiedad: VT_I4
Valores válidos: WIA_PROP_LIST
Derechos de acceso: lectura y escritura
Observaciones
Para seleccionar las dimensiones de la página que se van a examinar, una aplicación establece WIA_DPS_PAGE_SIZE. El minidriver WIA crea y mantiene esta propiedad.
En la tabla siguiente se describen las constantes que son válidas con WIA_IPS_PAGE_SIZE.
| Value | Definición |
|---|---|
| WIA_PAGE_A4 | El tamaño de página es 8267 × 11692 (orientación VERTICAL). |
| WIA_PAGE_CUSTOM | El tamaño de página se define mediante los valores de las propiedades WIA_DPS_PAGE_HEIGHT y WIA_DPS_PAGE_WIDTH . |
| WIA_PAGE_LETTER | El tamaño de página es 8500 × 11000 (orientación VERTICAL). |
El valor de la propiedad WIA_IPS_ORIENTATION determina la orientación de la página seleccionada actualmente. Las propiedades WIA_DPS_PAGE_WIDTH y WIA_DPS_PAGE_HEIGHT notifican las dimensiones de la página, en milésimas de pulgada (.001). Estas propiedades deben tener valores equivalentes a las propiedades WIA_IPS_XEXTENT y WIA_IPS_YEXTENT , que contienen las dimensiones de la página, en píxeles.
los valores con tipo WIA_PROP_LIST deben depender de la configuración válida de la propiedad WIA_IPS_ORIENTATION. Si un dispositivo no puede examinar documentos orientados a horizontal con una configuración de WIA_PAGE_A4, WIA_PAGE_A4 no debería aparecer en la lista de valores válidos para la propiedad WIA_DPS_PAGE_SIZE cuando WIA_IPS_ORIENTATION se establece en LANDSCAPE.
Si una aplicación establece WIA_DPS_PAGE_SIZE en cualquier valor distinto de WIA_PAGE_CUSTOM, el minidriver debe ajustar los valores de WIA_DPS_PAGE_WIDTH y WIA_DPS_PAGE_HEIGHT a las dimensiones de la página, en milésimas de pulgada (.001). El minidriver también debe ajustar los valores de WIA_IPS_XEXTENT y WIA_IPS_YEXTENT a las dimensiones de la página, en píxeles.
Si se cambia una configuración de extensión (WIA_IPS_XEXTENT o WIA_IPS_YEXTENT) a un valor que no coincide con la configuración actual de tamaño de página, el minidriver debe cambiar el valor de la propiedad WIA_DPS_PAGE_SIZE a WIA_PAGE_CUSTOM. El minidriver también debe modificar WIA_DPS_PAGE_WIDTH o WIA_DPS_PAGE_HEIGHT de acuerdo con la nueva configuración de extensión.
Si WIA_IPS_ORIENTATION se establece en LANDSCAPE, la configuración de extensión será "volteada". Por ejemplo, si una aplicación establece WIA_DPS_PAGE_SIZE en WIA_PAGE_A4, el minidriver debe establecer WIA_DPS_PAGE_WIDTH en 11692 y WIA_DPS_PAGE_HEIGHT en 8267. (El minidriver también debe establecer WIA_IPS_XEXTENT y WIA_IPS_YEXTENT en consecuencia). Tenga en cuenta que si WIA_DPS_PAGE_SIZE se establece en WIA_PAGE_CUSTOM, la configuración de orientación no se usa para determinar las dimensiones de extensión de la página que se van a examinar.
El minidriver debe asegurarse de que la propiedad WIA_IPS_ORIENTATION está de acuerdo con el área de selección actual. Si una aplicación cambia el valor de WIA_IPS_ORIENTATION a uno que no es válido para el tamaño de página seleccionado actualmente, el minidriver debe cambiar el valor de WIA_DPS_PAGE_SIZE a un tamaño de página compatible con el nuevo valor de orientación.
Si una aplicación establece la propiedad WIA_DPS_PAGE_SIZE en WIA_PAGE_CUSTOM, el área de selección actual no se ve afectada. El minidriver WIA debe obtener el diseño de imagen actual, empezando por la configuración actual de las propiedades WIA_IPS_XPOS y WIA_IPS_YPOS . Si la configuración de tamaño de página da como resultado un área de selección que está fuera de la cama del escáner, el minidriver debe ajustar automáticamente los valores de la WIA_IPS_XPOS y WIA_IPS_YPOS propiedades a valores válidos. Si las propiedades WIA_DPS_PAGE_SIZE y WIA_IPS_ORIENTATION se establecen al mismo tiempo y no son válidas cuando se aplican en combinación, el minidriver debe producir un error en la configuración de la aplicación devolviendo un error en el método IWiaMiniDrv::d rvValidateItemProperties .
En los cuatro ejemplos de código siguientes se muestran los siguientes escenarios de WIA_DPS_PAGE_SIZE:
El controlador informa de la configuración.
Una aplicación establece la propiedad WIA_DPS_PAGE_SIZE en WIA_PAGE_LETTER.
Una aplicación establece la propiedad WIA_IPS_ORIENTATION en LANDSCAPE.
Una aplicación cambia la propiedad WIA_IPS_XEXTENT a un valor más pequeño.
Ejemplo 1: El minidriver informa de la configuración
En el ejemplo de código siguiente, el minidriver establece un área de selección personalizada antes de que una aplicación establezca las propiedades de WIA. En este caso, el área de selección representa todo el plano.
WIA_DPS_PAGE_SIZE = WIA_PAGE_CUSTOM WIA_DPS_PAGE_WIDTH = 11500 WIA_DPS_PAGE_HEIGHT = 14000 WIA_IPS_ORIENTATION = VERTICAL WIA_IPS_XPOS = 0 WIA_IPS_YPOS = 0 WIA_IPS_XEXTENT = 1150 WIA_IPS_YEXTENT = 1400 WIA_IPS_XRES = 100 WIA_IPS_YRES = 100
Ejemplo 2: Una aplicación establece la propiedad WIA_DPS_PAGE_SIZE en WIA_PAGE_LETTER
WIA_DPS_PAGE_SIZE = WIA_PAGE_LETTER WIA_DPS_PAGE_WIDTH = 8500 WIA_DPS_PAGE_HEIGHT = 11000 WIA_IPS_ORIENTATION = VERTICAL WIA_IPS_XPOS = 0 WIA_IPS_YPOS = 0 WIA_IPS_XEXTENT = 850 WIA_IPS_YEXTENT = 1100 WIA_IPS_XRES = 100 WIA_IPS_YRES = 100
Ejemplo 3: Una aplicación establece la propiedad WIA_IPS_ORIENTATION en LANDSCAPE
La cama física debe ser capaz de adquirir una página que originalmente estaba en orientación horizontal.
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
Ejemplo 4: Una aplicación cambia la propiedad WIA_IPS_XEXTENT a un valor más pequeño
En el ejemplo de código siguiente, una aplicación cambia la propiedad WIA_IPS_XEXTENT a 1000. El minidriver debe suponer que el nuevo valor de WIA_IPS_XEXTENT ya no es válido para la propiedad WIA_DPS_PAGE_SIZE y, por tanto, debe cambiar WIA_DPS_PAGE_SIZE a WIA_PAGE_CUSTOM. El minidriver también debe 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
Versión: Obsoleto, use la propiedad WIA_IPS_PAGE_SIZE en su lugar.
Encabezado: wiadef.h (incluya Wiadef.h)