WIA_IPS_YPOS

Die WIA_IPS_YPOS-Eigenschaft enthält die aktuelle y-Koordinate (in Pixel) der oberen linken Ecke eines ausgewählten Bilds. Der WIA-Minitreiber erstellt und verwaltet diese Eigenschaft.

Eigenschaftstyp: VT_I4

Gültige Werte: WIA_PROP_RANGE

Zugriffsrechte: Lese-/Schreibzugriff

Bemerkungen

Eine Anwendung legt die WIA_IPS_YPOS-Eigenschaft fest, um die obere linke Ecke eines Auswahlbereichs zu markieren.

WIA_IPS_YPOS ist für alle bilderfassungsfähigen Elemente und untergeordneten Elemente dieser Elemente erforderlich; Diese Eigenschaft ist nicht für Speicherelemente oder gespeicherte Bildelemente verfügbar.

Wenn eine feste Seitengröße festgelegt ist, muss der Treiber die Eigenschaften WIA_IPS_XEXTENT, WIA_IPS_XPOS, WIA_IPS_YEXTENT und WIA_IPS_YPOS so festlegen, dass sie den Seitengrößen und einem "0"-Ursprung entsprechen. Für die Ausrichtung des mittleren Dokuments muss der Treiber WIA_IPS_XPOS auf ((Scanbereichsbreite - Dokumentbreite) / 2) * Auflösung [DPI]) und WIA_IPS_YPOS auf ((Scanbereichshöhe - Dokumenthöhe) / 2) * Auflösung [DPI]) festlegen.

Wenn der Ursprung oder eine Erweiterung geändert wird, muss der Treiber die WIA_IPS_PAGE_SIZE-Eigenschaft auf CUSTOM_SIZE und die eigenschaften WIA_IPS_PAGE_WIDTH und WIA_IPS_PAGE_HEIGHT aktualisieren, um den Scanbereichsausdehnungen zu entsprechen. Ausrichtung und Drehung sollten sich nicht auf diese Eigenschaften auswirken, es sei denn, eine Ausrichtungsänderung (keine Drehungsänderung) rendert den Ursprung oder einen Bereich außerhalb des verfügbaren Dokumentscanbereichs.

Ein Treiber muss auch WIA_IPS_XEXTENT-, WIA_IPS_XPOS-, WIA_IPS_YEXTENT- und WIA_IPS_YPOS-Eigenschaften aktualisieren, wenn die Eigenschaften WIA_IPS_XRES und WIA_IPS_YRES geändert werden.

Hinweis

Untergeordnete Elemente mit Flatbed und Film müssen nur die Eigenschaften WIA_IPS_XEXTENT, WIA_IPS_XPOS, WIA_IPS_XRES, WIA_IPS_YEXTENT, WIA_IPS_YPOS und WIA_IPS_YRES unterstützen. Alle anderen Eigenschaften, die für ihr übergeordnetes Element erforderlich oder optional sind (die Basiselemente Flatbed oder Film), sind nur für diese Elemente optional. Die einzigen Ausnahmen sind die WIA_IPA_ITEM_Xxx-Eigenschaften , die für alle Elemente erforderlich sind.

Anforderungen

Header: wiadef.h (include Wiadef.h)

Weitere Informationen

WIA_IPS_PAGE_HEIGHT

WIA_IPS_PAGE_SIZE

WIA_IPS_PAGE_WIDTH

WIA_IPS_XEXTENT

WIA_IPS_XPOS

WIA_IPS_XRES

WIA_IPS_YEXTENT

WIA_IPS_YRES