Freigeben über


WIA_IPS_XEXTENT

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

Eigenschaftstyp: VT_I4

Gültige Werte: WIA_PROP_RANGE

Zugriffsrechte: Lese-/Schreibzugriff

Bemerkungen

Eine Anwendung legt die WIA_IPS_XEXTENT-Eigenschaft fest, um die obere linke Ecke (d. h. die Breite) des zu abrufenden Auswahlbereichs zu markieren. Der Minidriver erstellt und verwaltet diese Eigenschaft.

WIA_IPS_XEXTENT ist für alle Elemente mit aktivierter Bilderfassung und untergeordnete Elemente dieser Elemente erforderlich; Diese Eigenschaft ist für Speicherelemente oder gespeicherte Imageelemente nicht 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 zentrierte Dokumentausrichtung 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 Blöcke geändert wird, muss der Treiber die WIA_IPS_PAGE_SIZE-Eigenschaft aktualisieren, um CUSTOM_SIZE sowie die Eigenschaften WIA_IPS_PAGE_WIDTH und WIA_IPS_PAGE_HEIGHT zu den Scanbereichsausdehnungen zu aktualisieren. 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 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.

Hinweis Untergeordnete Elemente für Flatbed 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 (Basis-Flatbed- 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)

Weitere Informationen

WIA_IPA_PIXELS_PER_LINE

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_YPOS

WIA_IPS_YRES