WIA_DPS_PAGE_SIZE
Die WIA_DPS_PAGE_SIZE-Eigenschaft enthält die Größe der Seite, die derzeit für die Überprüfung ausgewählt ist.
Eigenschaftstyp: VT_I4
Gültige Werte: WIA_PROP_LIST
Zugriffsrechte: Lese-/Schreibzugriff
Bemerkungen
Um die Dimensionen der zu überprüfenden Seite auszuwählen, legt eine Anwendung WIA_DPS_PAGE_SIZE fest. Der WIA-Minitreiber 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 geben die Seitenabmessungen in Tausendstel Zoll (.001) an. Diese Eigenschaften müssen Werte aufweisen, die den Eigenschaften WIA_IPS_XEXTENT und WIA_IPS_YEXTENT , die die Seitenabmessungen enthalten, in Pixeln entsprechen.
WIA_PROP_LIST typisierte Werte sollten von gültigen Einstellungen der WIA_IPS_ORIENTATION-Eigenschaft abhängen. Wenn ein Gerät keine querformatorientierten 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 LANDSCAPE 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 an die Seitenabmessungen in Tausendstel Zoll (.001) anpassen. Der Minidriver sollte auch die Werte von WIA_IPS_XEXTENT und WIA_IPS_YEXTENT an die Abmessungen der Seite in Pixel 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 Minitreiber den Wert der WIA_DPS_PAGE_SIZE-Eigenschaft 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 LANDSCAPE festgelegt ist, werden die Erweiterungseinstellungen "umgedreht". Wenn eine Anwendung beispielsweise WIA_DPS_PAGE_SIZE auf WIA_PAGE_A4 festlegt, sollte der Minitreiber WIA_DPS_PAGE_WIDTH auf 11692 und WIA_DPS_PAGE_HEIGHT auf 8267 festlegen. (Der Minitreiber sollte auch WIA_IPS_XEXTENT festlegen und entsprechend WIA_IPS_YEXTENT.) Wenn WIA_DPS_PAGE_SIZE auf WIA_PAGE_CUSTOM festgelegt ist, wird die Ausrichtungseinstellung nicht verwendet, um die Ausmaße der zu scannenden Seite zu bestimmen.
Der Minitreiber muss sicherstellen, dass die eigenschaft WIA_IPS_ORIENTATION mit dem aktuellen Auswahlbereich übereinstimmt. Wenn eine Anwendung den Wert von WIA_IPS_ORIENTATION in einen wert ändert, der für die aktuell ausgewählte Seitengröße ungültig ist, sollte der Minitreiber den Wert von WIA_DPS_PAGE_SIZE in eine Seitengröße ändern, die vom neuen Ausrichtungswert unterstützt wird.
Wenn eine Anwendung die WIA_DPS_PAGE_SIZE-Eigenschaft auf WIA_PAGE_CUSTOM festlegt, ist der aktuelle Auswahlbereich nicht betroffen. Der WIA-Minitreiber sollte das aktuelle Bildlayout abrufen, beginnend mit den aktuellen Einstellungen der eigenschaften WIA_IPS_XPOS und WIA_IPS_YPOS . Wenn die Einstellung für die Seitengröße 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 sind und ungültig sind, wenn sie in Kombination angewendet werden, sollte der Minitreiber die Einstellungen der Anwendung durch Zurückgeben eines Fehlers in der IWiaMiniDrv::d rvValidateItemProperties-Methode fehlschlagen .
Die folgenden vier Codebeispiele zeigen die folgenden WIA_DPS_PAGE_SIZE Szenarien:
Der Treiber meldet die Einstellungen.
Eine Anwendung legt die WIA_DPS_PAGE_SIZE-Eigenschaft 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 Minitreiber 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
Beispiel 3: Eine Anwendung legt die eigenschaft WIA_IPS_ORIENTATION auf LANDSCAPE fest
Das physische Bett muss in der Lage sein, eine Seite zu erhalten, die sich ursprünglich im Querformat befand.
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
Beispiel 4: Eine Anwendung ändert die eigenschaft WIA_IPS_XEXTENT 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 eigenschaft WIA_DPS_PAGE_SIZE nicht mehr gültig ist, und sollte daher WIA_DPS_PAGE_SIZE in WIA_PAGE_CUSTOM ändern. Der Minitreiber 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: Veraltet, verwenden Sie stattdessen die eigenschaft WIA_IPS_PAGE_SIZE.
Header: wiadef.h (include Wiadef.h)