WIA_IPS_XPOS

Article
06/15/2023

La propriété WIA_IPS_XPOS contient la coordonnée x, en pixels, du coin supérieur gauche d’une image sélectionnée. Le minidriver WIA crée et gère cette propriété.

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_XPOS pour marquer le coin supérieur gauche d’une zone de sélection.

WIA_IPS_XPOS 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 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 WIA_IPS_PAGE_SIZE pour CUSTOM_SIZE et les propriétés WIA_IPS_PAGE_WIDTH et WIA_IPS_PAGE_HEIGHT pour correspondre 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 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 (é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.