WIA_DPS_PAGE_SIZE
La propriété WIA_DPS_PAGE_SIZE contient la taille de la page actuellement sélectionnée pour être analysée.
Type de propriété : VT_I4
Valeurs valides : WIA_PROP_LIST
Droits d’accès : lecture/écriture
Notes
Pour sélectionner les dimensions de la page à analyser, une application définit WIA_DPS_PAGE_SIZE. Le minidriver WIA crée et gère cette propriété.
Le tableau suivant décrit les constantes valides avec WIA_IPS_PAGE_SIZE.
| Valeur | Définition |
|---|---|
| WIA_PAGE_A4 | La taille de page est 8267 × 11692 (orientation PORTRAIT). |
| WIA_PAGE_CUSTOM | La taille de page est définie par les valeurs des propriétés WIA_DPS_PAGE_HEIGHT et WIA_DPS_PAGE_WIDTH . |
| WIA_PAGE_LETTER | La taille de page est de 8500 × 11000 (orientation PORTRAIT). |
La valeur de la propriété WIA_IPS_ORIENTATION détermine l’orientation de la page actuellement sélectionnée. Les propriétés WIA_DPS_PAGE_WIDTH et WIA_DPS_PAGE_HEIGHT indiquent les dimensions de la page, en millièmes de pouce (.001). Ces propriétés doivent avoir des valeurs équivalentes aux propriétés WIA_IPS_XEXTENT et WIA_IPS_YEXTENT , qui contiennent les dimensions de la page, en pixels.
WIA_PROP_LIST valeurs de type doivent dépendre des paramètres valides de la propriété WIA_IPS_ORIENTATION. Si un appareil ne peut pas analyser des documents orientés paysage avec un paramètre de WIA_PAGE_A4, WIA_PAGE_A4 ne doit pas apparaître dans la liste des valeurs valides pour la propriété WIA_DPS_PAGE_SIZE lorsque WIA_IPS_ORIENTATION est défini sur PAYSAGE.
Si une application définit WIA_DPS_PAGE_SIZE sur une valeur autre que WIA_PAGE_CUSTOM, le minidriver doit ajuster les valeurs de WIA_DPS_PAGE_WIDTH et WIA_DPS_PAGE_HEIGHT aux dimensions de la page, en millièmes de pouce (.001). Le minidriver doit également ajuster les valeurs de WIA_IPS_XEXTENT et WIA_IPS_YEXTENT aux dimensions de la page, en pixels.
Si un paramètre d’étendue (WIA_IPS_XEXTENT ou WIA_IPS_YEXTENT) est remplacé par une valeur qui ne correspond pas au paramètre de taille de page actuel, le minidriver doit modifier la valeur de la propriété WIA_DPS_PAGE_SIZE en WIA_PAGE_CUSTOM. Le minidriver doit également modifier WIA_DPS_PAGE_WIDTH ou WIA_DPS_PAGE_HEIGHT en fonction du nouveau paramètre d’étendue.
Si WIA_IPS_ORIENTATION est défini sur PAYSAGE, les paramètres d’étendue sont « retournés ». Par exemple, si une application définit WIA_DPS_PAGE_SIZE sur WIA_PAGE_A4, le minidriver doit définir WIA_DPS_PAGE_WIDTH sur 11692 et WIA_DPS_PAGE_HEIGHT sur 8267. (Le minidriver doit également définir WIA_IPS_XEXTENT et WIA_IPS_YEXTENT en conséquence.) Notez que si WIA_DPS_PAGE_SIZE est défini sur WIA_PAGE_CUSTOM, le paramètre d’orientation n’est pas utilisé pour déterminer les dimensions d’étendue de la page à analyser.
Le minidriver doit s’assurer que la propriété WIA_IPS_ORIENTATION est d’accord avec la zone de sélection actuelle. Si une application remplace la valeur de WIA_IPS_ORIENTATION par une valeur non valide pour la taille de page actuellement sélectionnée, le minidriver doit modifier la valeur de WIA_DPS_PAGE_SIZE par une taille de page prise en charge par la nouvelle valeur d’orientation.
Si une application définit la propriété WIA_DPS_PAGE_SIZE sur WIA_PAGE_CUSTOM, la zone de sélection actuelle n’est pas affectée. Le minidriver WIA doit obtenir la disposition actuelle de l’image, en commençant par les paramètres actuels des propriétés WIA_IPS_XPOS et WIA_IPS_YPOS . Si le paramètre de taille de page aboutit à une zone de sélection située à l’extérieur du lit du scanneur, le mini-lecteur doit ajuster automatiquement les valeurs des propriétés WIA_IPS_XPOS et WIA_IPS_YPOS aux paramètres valides. Si les propriétés WIA_DPS_PAGE_SIZE et WIA_IPS_ORIENTATION sont définies en même temps et qu’elles ne sont pas valides lorsqu’elles sont appliquées en combinaison, le minidriver doit échouer dans les paramètres de l’application en retournant une erreur dans la méthode IWiaMiniDrv::d rvValidateItemProperties .
Les quatre exemples de code suivants illustrent les scénarios de WIA_DPS_PAGE_SIZE suivants :
Le pilote signale les paramètres.
Une application définit la propriété WIA_DPS_PAGE_SIZE sur WIA_PAGE_LETTER.
Une application définit la propriété WIA_IPS_ORIENTATION sur PAYSAGE.
Une application remplace la propriété WIA_IPS_XEXTENT par une valeur plus petite.
Exemple 1 : le minidriver signale les paramètres
Dans l’exemple de code suivant, le minidriver définit une zone de sélection personnalisée avant qu’une application ne définisse les propriétés WIA. Dans ce cas, la zone de sélection représente l’intégralité du lit plat.
WIA_DPS_PAGE_SIZE = WIA_PAGE_CUSTOM WIA_DPS_PAGE_WIDTH = 11500 WIA_DPS_PAGE_HEIGHT = 14000 WIA_IPS_ORIENTATION = PORTRAIT WIA_IPS_XPOS = 0 WIA_IPS_YPOS = 0 WIA_IPS_XEXTENT = 1150 WIA_IPS_YEXTENT = 1400 WIA_IPS_XRES = 100 WIA_IPS_YRES = 100
Exemple 2 : une application définit la propriété WIA_DPS_PAGE_SIZE sur WIA_PAGE_LETTER
WIA_DPS_PAGE_SIZE = WIA_PAGE_LETTER WIA_DPS_PAGE_WIDTH = 8500 WIA_DPS_PAGE_HEIGHT = 11000 WIA_IPS_ORIENTATION = PORTRAIT WIA_IPS_XPOS = 0 WIA_IPS_YPOS = 0 WIA_IPS_XEXTENT = 850 WIA_IPS_YEXTENT = 1100 WIA_IPS_XRES = 100 WIA_IPS_YRES = 100
Exemple 3 : Une application définit la propriété WIA_IPS_ORIENTATION sur PAYSAGE
Le lit physique doit être en mesure d’acquérir une page qui était à l’origine en orientation paysage.
WIA_DPS_PAGE_SIZE = WIA_PAGE_LETTER WIA_DPS_PAGE_HEIGHT = 11000 WIA_DPS_PAGE_WIDTH = 8500 WIA_IPS_ORIENTATION = paysage WIA_IPS_XPOS = 0 WIA_IPS_YPOS = 0 WIA_IPS_XEXTENT = 1100 WIA_IPS_YEXTENT = 850 WIA_IPS_XRES = 100 WIA_IPS_YRES = 100
Exemple 4 : Une application modifie la propriété WIA_IPS_XEXTENT en une valeur plus petite
Dans l’exemple de code suivant, une application remplace la propriété WIA_IPS_XEXTENT par 1000. Le minidriver doit supposer que la nouvelle valeur de WIA_IPS_XEXTENT n’est plus valide pour la propriété WIA_DPS_PAGE_SIZE et doit donc changer WIA_DPS_PAGE_SIZE en WIA_PAGE_CUSTOM. Le minidriver doit également ajuster WIA_DPS_PAGE_WIDTH.
WIA_DPS_PAGE_SIZE = WIA_PAGE_CUSTOM WIA_DPS_PAGE_HEIGHT = 10000 WIA_DPS_PAGE_WIDTH = 8500 WIA_IPS_ORIENTATION = paysage WIA_IPS_XPOS = 0 WIA_IPS_YPOS = 0 WIA_IPS_XEXTENT = 1000 WIA_IPS_YEXTENT = 850 WIA_IPS_XRES = 100 WIA_IPS_YRES = 100
Spécifications
Version: Obsolète, utilisez plutôt la propriété WIA_IPS_PAGE_SIZE.
En-tête : wiadef.h (inclure Wiadef.h)