Freigeben über


WIA_IPS_XPOS

Die WIA_IPS_XPOS-Eigenschaft enthält die x-Koordinate in Pixeln der oberen linken Ecke eines ausgewählten Bilds. Der WIA-Minidriver erstellt und verwaltet diese Eigenschaft.

Eigenschaftentyp: VT_I4

Gültige Werte: WIA_PROP_RANGE

Zugriffsrechte: Lese-/Schreibzugriff

Bemerkungen

Eine Anwendung legt die WIA_IPS_XPOS-Eigenschaft so fest, dass die obere linke Ecke eines Auswahlbereichs markiert wird.

WIA_IPS_XPOS ist für alle bildabruffähigen Elemente und untergeordnete Elemente dieser Elemente erforderlich; Diese Eigenschaft ist für Speicherelemente oder gespeicherte Bildelemente nicht verfügbar.

Wenn ein festes Seitenformat festgelegt ist, muss der Treiber die WIA_IPS_XEXTENT, WIA_IPS_XPOS, WIA_IPS_YEXTENT und WIA_IPS_YPOS Eigenschaften festlegen, um den Abmessungen der Seitengröße und einem "0"-Ursprung zu entsprechen. Für die zentrierte Dokumentausrichtung muss der Treiber WIA_IPS_XPOS auf ((Scanbereichbreite - Dokumentbreite) / 2) * Auflösung [DPI]) und WIA_IPS_YPOS auf ((Scanbereich höhe - Dokumenthöhe) / 2) * Auflösung [DPI]) festlegen.

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

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

Hinweis

Untergeordnete Elemente mit Flachbett und Film sind erforderlich, um nur die Eigenschaften WIA_IPS_XEXTENT, WIA_IPS_XPOS, WIA_IPS_XRES, WIA_IPS_YEXTENT, WIA_IPS_YPOS und WIA_IPS_YRES zu unterstützen. Alle anderen Eigenschaften, die für ihr übergeordnetes Element erforderlich oder optional sind (die Basis-Flachbett- oder Filmelemente), 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)

Siehe auch

WIA_IPS_PAGE_HEIGHT

WIA_IPS_PAGE_SIZE

WIA_IPS_PAGE_WIDTH

WIA_IPS_XEXTENT

WIA_IPS_XRES

WIA_IPS_YEXTENT

WIA_IPS_YPOS

WIA_IPS_YRES