WIA_IPS_XEXTENT

Article
06/15/2023

La propriété WIA_IPS_XEXTENT contient la largeur 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_XEXTENT pour marquer le coin supérieur gauche (c’est-à-dire la largeur) de la zone de sélection à acquérir. Le minidriver crée et gère cette propriété.

WIA_IPS_XEXTENT est nécessaire 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 la zone de numérisation - hauteur du document) / 2) * résolution [PPP]).

Lorsque l’origine ou une extension est modifiée, le pilote doit mettre à jour la propriété 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) restitue 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 WIA_IPS_XRES et WIA_IPS_YRES sont modifiés.

Note Les éléments enfants à plat et film doivent 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 (éléments flatbed ou Film de base), 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.