WIA_IPS_YEXTENT

Article
06/14/2023

La propriété WIA_IPS_YEXTENT contient la hauteur actuelle, en pixels, d’une image sélectionnée à acquérir.

Type de propriété : VT_I4

Valeurs valides : WIA_PROP_RANGE

Droits d’accès : lecture/écriture

Notes

Une application définit la propriété WIA_IPS_YEXTENT pour marquer le coin supérieur gauche (c’est-à-dire la hauteur) d’une zone de sélection à acquérir. Le minidriver WIA crée et gère cette propriété.

WIA_IPS_YEXTENT est requis pour tous les éléments activés pour l’acquisition d’images et les éléments enfants de ces éléments ; cette propriété n’est pas disponible pour les éléments de stockage ou les éléments d’image stockés.

Lorsqu’une taille de page fixe est définie, le pilote doit définir les propriétés WIA_IPS_XEXTENT, WIA_IPS_XPOS, WIA_IPS_YEXTENT et WIA_IPS_YPOS pour qu’elles correspondent aux dimensions de taille de page et à l’origine « 0 ». Pour l’alignement du document au centre, le pilote doit définir WIA_IPS_XPOS sur ((largeur de la zone de numérisation - largeur du document) / 2) * résolution [PPP]) et WIA_IPS_YPOS sur ((hauteur de zone de numérisation - hauteur du document) / 2) * résolution [PPP]).

Lorsque l’origine ou une étendue est modifiée, le pilote doit mettre à jour le WIA_IPS_PAGE_SIZE pour CUSTOM_SIZE et les propriétés WIA_IPS_PAGE_WIDTH et WIA_IPS_PAGE_HEIGHT pour qu’elles correspondent aux étendues de la zone d’analyse. L’orientation et la rotation ne doivent pas affecter ces propriétés, sauf si un changement d’orientation (et non un changement de rotation) rend l’origine ou une étendue en dehors de la zone d’analyse de document disponible.

Un pilote doit également mettre à jour les propriétés WIA_IPS_XEXTENT, WIA_IPS_XPOS, WIA_IPS_YEXTENT et WIA_IPS_YPOS lorsque les propriétés WIA_IPS_XRES et WIA_IPS_YRES sont modifiées.

Notes

Les éléments enfants à plat et film sont nécessaires pour prendre en charge uniquement les propriétés WIA_IPS_XEXTENT, WIA_IPS_XPOS, WIA_IPS_XRES, WIA_IPS_YEXTENT, WIA_IPS_YPOS et WIA_IPS_YRES. Toutes les autres propriétés, obligatoires ou facultatives pour leur parent (les éléments à plat de base ou film), sont uniquement facultatives pour ces éléments. Les seules exceptions sont les propriétés WIA_IPA_ITEM_Xxx , qui sont requises pour tous les éléments.