Hinweis
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, sich anzumelden oder das Verzeichnis zu wechseln.
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, das Verzeichnis zu wechseln.
Die WIA_DPS_PAGE_SIZE-Eigenschaft enthält die Größe der Seite, die derzeit für die Überprüfung ausgewählt ist.
Eigenschaftentyp: VT_I4
Gültige Werte: WIA_PROP_LIST
Zugriffsrechte: Lese-/Schreibzugriff
Bemerkungen
Um die zu scannenden Abmessungen der Seite auszuwählen, legt eine Anwendung WIA_DPS_PAGE_SIZE fest. Der WIA-Minidriver erstellt und verwaltet diese Eigenschaft.
In der folgenden Tabelle werden die Konstanten beschrieben, die mit WIA_IPS_PAGE_SIZE gültig sind.
| Wert | Definition |
|---|---|
| WIA_PAGE_A4 | Die Seitengröße beträgt 8267 × 11692 (HOCHFORMAT). |
| WIA_PAGE_CUSTOM | Die Seitengröße wird durch die Werte der eigenschaften WIA_DPS_PAGE_HEIGHT und WIA_DPS_PAGE_WIDTH definiert. |
| WIA_PAGE_LETTER | Die Seitengröße beträgt 8500 × 11000 (HOCHFORMAT). |
Der Wert der WIA_IPS_ORIENTATION-Eigenschaft bestimmt die Ausrichtung der aktuell ausgewählten Seite. Die eigenschaften WIA_DPS_PAGE_WIDTH und WIA_DPS_PAGE_HEIGHT melden die Abmessungen der Seite in Tausendstel zoll (001). Diese Eigenschaften müssen Werte aufweisen, die den WIA_IPS_XEXTENT und WIA_IPS_YEXTENT Eigenschaften entsprechen, die die Abmessungen der Seite enthalten, in Pixeln.
WIA_PROP_LIST Typwerte sollten von gültigen Einstellungen der WIA_IPS_ORIENTATION-Eigenschaft abhängen. Wenn ein Gerät keine querformatigen Dokumente mit einer WIA_PAGE_A4 Einstellung scannen kann, sollte WIA_PAGE_A4 nicht in der Liste der gültigen Werte für die eigenschaft WIA_DPS_PAGE_SIZE angezeigt werden, wenn WIA_IPS_ORIENTATION auf QUERFORMAT festgelegt ist.
Wenn eine Anwendung WIA_DPS_PAGE_SIZE auf einen anderen Wert als WIA_PAGE_CUSTOM festlegt, sollte der Minidriver die Werte von WIA_DPS_PAGE_WIDTH und WIA_DPS_PAGE_HEIGHT auf die Abmessungen der Seite in Tausendstel zoll (001) anpassen. Der Minidriver sollte auch die Werte von WIA_IPS_XEXTENT und WIA_IPS_YEXTENT auf die Abmessungen der Seite in Pixeln anpassen.
Wenn eine Erweiterungseinstellung (WIA_IPS_XEXTENT oder WIA_IPS_YEXTENT) in einen Wert geändert wird, der nicht mit der aktuellen Einstellung für die Seitengröße übereinstimmt, sollte der Minidriver den Wert der eigenschaft WIA_DPS_PAGE_SIZE in WIA_PAGE_CUSTOM ändern. Der Minidriver sollte auch WIA_DPS_PAGE_WIDTH oder WIA_DPS_PAGE_HEIGHT entsprechend der neuen Erweiterungseinstellung ändern.
Wenn WIA_IPS_ORIENTATION auf QUERFORMAT festgelegt ist, wird der Umfang der Einstellungen "gekippt" angezeigt. Wenn eine Anwendung z. B. WIA_DPS_PAGE_SIZE auf WIA_PAGE_A4 festlegt, sollte der Minidriver WIA_DPS_PAGE_WIDTH auf 11692 und WIA_DPS_PAGE_HEIGHT auf 8267 festlegen. (Der Minidriver sollte auch WIA_IPS_XEXTENT und entsprechend WIA_IPS_YEXTENT festlegen.) Wenn WIA_DPS_PAGE_SIZE auf WIA_PAGE_CUSTOM festgelegt ist, wird die Ausrichtungseinstellung nicht verwendet, um den Umfang der zu scannenden Seite zu bestimmen.
Der Minidriver muss sicherstellen, dass die WIA_IPS_ORIENTATION-Eigenschaft dem aktuellen Auswahlbereich zustimmt. Wenn eine Anwendung den Wert von WIA_IPS_ORIENTATION in eine ändert, die für die aktuell ausgewählte Seitengröße ungültig ist, sollte der Minidriver den Wert von WIA_DPS_PAGE_SIZE in ein Seitenformat ändern, das vom neuen Ausrichtungswert unterstützt wird.
Wenn eine Anwendung die eigenschaft WIA_DPS_PAGE_SIZE auf WIA_PAGE_CUSTOM festlegt, ist der aktuelle Auswahlbereich nicht betroffen. Der WIA-Minidriver sollte das aktuelle Bildlayout abrufen, beginnend mit den aktuellen Einstellungen der WIA_IPS_XPOS und WIA_IPS_YPOS Eigenschaften. Wenn die Seitenformateinstellung zu einem Auswahlbereich führt, der sich außerhalb des Scannerbetts befindet, muss der Minidriver die Werte der WIA_IPS_XPOS und WIA_IPS_YPOS Eigenschaften automatisch an gültige Einstellungen anpassen. Wenn die Eigenschaften WIA_DPS_PAGE_SIZE und WIA_IPS_ORIENTATION gleichzeitig festgelegt werden und ungültig sind, wenn sie in Kombination angewendet werden, sollte der Minidriver die Einstellungen der Anwendung fehlschlagen, indem ein Fehler in der IWiaMiniDrv::d rvValidateItemProperties-Methode zurückgegeben wird.
Die folgenden vier Codebeispiele zeigen die folgenden WIA_DPS_PAGE_SIZE Szenarien:
Der Treiber meldet die Einstellungen.
Eine Anwendung legt die eigenschaft WIA_DPS_PAGE_SIZE auf WIA_PAGE_LETTER fest.
Eine Anwendung legt die WIA_IPS_ORIENTATION-Eigenschaft auf LANDSCAPE fest.
Eine Anwendung ändert die WIA_IPS_XEXTENT Eigenschaft in einen kleineren Wert.
Beispiel 1: Der Minidriver meldet die Einstellungen.
Im folgenden Codebeispiel legt der Minidriver einen benutzerdefinierten Auswahlbereich fest, bevor eine Anwendung WIA-Eigenschaften festlegt. In diesem Fall stellt der Auswahlbereich das gesamte Flachbett dar.
WIA_DPS_PAGE_SIZE = WIA_PAGE_CUSTOM WIA_DPS_PAGE_WIDTH = 11500 WIA_DPS_PAGE_HEIGHT = 14000 WIA_IPS_ORIENTATION = PORTRAIT WIA_IPS_XPOS = 0 WIA_IPS_YPOS = 0 WIA_IPS_XEXTENT = 1150 WIA_IPS_YEXTENT = 1400 WIA_IPS_XRES = 100 WIA_IPS_YRES = 100
Beispiel 2: Eine Anwendung legt die eigenschaft WIA_DPS_PAGE_SIZE auf WIA_PAGE_LETTER
WIA_DPS_PAGE_SIZE = WIA_PAGE_LETTER WIA_DPS_PAGE_WIDTH = 8500 WIA_DPS_PAGE_HEIGHT = 11000 WIA_IPS_ORIENTATION = PORTRAIT WIA_IPS_XPOS = 0 WIA_IPS_YPOS = 0 WIA_IPS_XEXTENT = 850 WIA_IPS_YEXTENT = 1100 WIA_IPS_XRES = 100 WIA_IPS_YRES = 100 WIA_IPS_YRES = 100
Beispiel 3: Eine Anwendung legt die WIA_IPS_ORIENTATION-Eigenschaft auf LANDSCAPE fest.
Das physische Bett muss in der Lage sein, eine Seite zu erwerben, die ursprünglich im Querformat war.
WIA_DPS_PAGE_SIZE = WIA_PAGE_LETTER WIA_DPS_PAGE_HEIGHT = 11000 WIA_DPS_PAGE_WIDTH = 8500 WIA_IPS_ORIENTATION = LANDSCAPE WIA_IPS_XPOS = 0 WIA_IPS_YPOS = 0 WIA_IPS_XEXTENT = 1100 WIA_IPS_YEXTENT = 850 WIA_IPS_XRES = 100 WIA_IPS_YRES = 100 WIA_IPS_YRES = 100
Beispiel 4: Eine Anwendung ändert die WIA_IPS_XEXTENT Eigenschaft in einen kleineren Wert.
Im folgenden Codebeispiel ändert eine Anwendung die eigenschaft WIA_IPS_XEXTENT in 1000. Der Minidriver sollte davon ausgehen, dass der neue Wert für WIA_IPS_XEXTENT für die WIA_DPS_PAGE_SIZE-Eigenschaft nicht mehr gültig ist und daher WIA_DPS_PAGE_SIZE in WIA_PAGE_CUSTOM ändern sollte. Der Minidriver muss auch WIA_DPS_PAGE_WIDTH anpassen.
WIA_DPS_PAGE_SIZE = WIA_PAGE_CUSTOM WIA_DPS_PAGE_HEIGHT = 10000 WIA_DPS_PAGE_WIDTH = 8500 WIA_IPS_ORIENTATION = LANDSCAPE WIA_IPS_XPOS = 0 WIA_IPS_YPOS = 0 WIA_IPS_XEXTENT = 1000 WIA_IPS_YEXTENT = 850 WIA_IPS_XRES = 100 WIA_IPS_YRES = 100
Anforderungen
Version: Verwenden Sie stattdessen die WIA_IPS_PAGE_SIZE-Eigenschaft.
Header: wiadef.h (include Wiadef.h)