Freigeben über


WIA_IPS_XEXTENT

Die WIA_IPS_XEXTENT-Eigenschaft enthält die aktuelle Breite eines ausgewählten Bilds in Pixeln, das erfasst werden soll.

Eigenschaftentyp: VT_I4

Gültige Werte: WIA_PROP_RANGE

Zugriffsrechte: Lese-/Schreibzugriff

Bemerkungen

Eine Anwendung legt die WIA_IPS_XEXTENT-Eigenschaft so fest, dass die obere linke Ecke (d. h. die Breite) des zu erwerbenden Auswahlbereichs markiert wird. Der Minidriver erstellt und verwaltet diese Eigenschaft.

WIA_IPS_XEXTENT ist für alle aktivierten Elemente des Bilderwerbs 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 die WIA_IPS_PAGE_SIZE Eigenschaft 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 WIA_IPS_XRES und WIA_IPS_YRES geändert werden.

Anmerkung Untergeordnete Elemente mit Flachbett und Film dürfen 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 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_IPA_PIXELS_PER_LINE

WIA_IPS_PAGE_HEIGHT

WIA_IPS_PAGE_SIZE

WIA_IPS_PAGE_WIDTH

WIA_IPS_XPOS

WIA_IPS_XRES

WIA_IPS_YEXTENT

WIA_IPS_YPOS

WIA_IPS_YRES