WIA_DPS_PAGE_SIZE
Свойство WIA_DPS_PAGE_SIZE содержит размер страницы, выбранной для сканирования.
Тип свойства: VT_I4
Допустимые значения: WIA_PROP_LIST
Права доступа: чтение и запись
Комментарии
Чтобы выбрать размеры просматриваемой страницы, приложение задает WIA_DPS_PAGE_SIZE. Мини-диск WIA создает и поддерживает это свойство.
В следующей таблице описаны константы, допустимые с WIA_IPS_PAGE_SIZE.
| Значение | Определение |
|---|---|
| WIA_PAGE_A4 | Размер страницы — 8267 × 11692 (ориентация КНИЖНАЯ). |
| WIA_PAGE_CUSTOM | Размер страницы определяется значениями свойств WIA_DPS_PAGE_HEIGHT и WIA_DPS_PAGE_WIDTH . |
| WIA_PAGE_LETTER | Размер страницы составляет 8500 × 11000 (ориентация КНИЖНАЯ). |
Значение свойства WIA_IPS_ORIENTATION определяет ориентацию текущей выбранной страницы. Свойства WIA_DPS_PAGE_WIDTH и WIA_DPS_PAGE_HEIGHT сообщают размеры страницы в тысячных долях дюйма (.001). Эти свойства должны иметь значения, эквивалентные WIA_IPS_XEXTENT и WIA_IPS_YEXTENT свойствам, содержащим размеры страницы, в пикселях.
WIA_PROP_LIST типизированные значения должны зависеть от допустимых параметров свойства WIA_IPS_ORIENTATION. Если устройство не может сканировать альбомно-ориентированные документы с параметром WIA_PAGE_A4, WIA_PAGE_A4 не должны отображаться в списке допустимых значений свойства WIA_DPS_PAGE_SIZE, если WIA_IPS_ORIENTATION имеет значение АЛЬБОМ.
Если приложение задает WIA_DPS_PAGE_SIZE любое значение, отличное от WIA_PAGE_CUSTOM, мини-диск должен настроить значения WIA_DPS_PAGE_WIDTH и WIA_DPS_PAGE_HEIGHT в соответствии с размерами страницы в тысячных долях дюйма (0,001). Мини-диск также должен настраивать значения WIA_IPS_XEXTENT и WIA_IPS_YEXTENT в соответствии с размерами страницы в пикселях.
Если параметр экстента (WIA_IPS_XEXTENT или WIA_IPS_YEXTENT) изменяется на значение, которое не соответствует текущему параметру размера страницы, мини-диск должен изменить значение свойства WIA_DPS_PAGE_SIZE на WIA_PAGE_CUSTOM. Мини-диск также должен изменять WIA_DPS_PAGE_WIDTH или WIA_DPS_PAGE_HEIGHT в соответствии с новым параметром экстента.
Если WIA_IPS_ORIENTATION задано значение АЛЬБОМ, параметры экстента будут "перевернуты". Например, если приложение задает для WIA_DPS_PAGE_SIZE значение WIA_PAGE_A4, мини-диск должен задать для WIA_DPS_PAGE_WIDTH значение 11692, а WIA_DPS_PAGE_HEIGHT — 8267. (Мини-диск также должен задать WIA_IPS_XEXTENT и WIA_IPS_YEXTENT соответствующим образом.) Обратите внимание, что если для WIA_DPS_PAGE_SIZE задано значение WIA_PAGE_CUSTOM, параметр ориентации не используется для определения размеров экстентов сканируемой страницы.
Мини-диск должен убедиться, что свойство WIA_IPS_ORIENTATION согласуется с текущей областью выбора. Если приложение изменяет значение WIA_IPS_ORIENTATION на недопустимое для текущего выбранного размера страницы, мини-диск должен изменить значение WIA_DPS_PAGE_SIZE на размер страницы, поддерживаемый новым значением ориентации.
Если приложение задает для свойства WIA_DPS_PAGE_SIZE значение WIA_PAGE_CUSTOM, текущая область выбора не затрагивается. Мини-накопитель WIA должен получить текущий макет изображения, начиная с текущих параметров WIA_IPS_XPOS и WIA_IPS_YPOS свойств. Если параметр размера страницы приводит к области выбора, которая находится за пределами кровати сканера, мини-диск должен автоматически настроить значения WIA_IPS_XPOS и WIA_IPS_YPOS свойства до допустимых параметров. Если свойства WIA_DPS_PAGE_SIZE и WIA_IPS_ORIENTATION заданы одновременно и они недопустимы при их применении в сочетании, мини-driver должен завершить настройку приложения ошибкой, возвращая ошибку в методе IWiaMiniDrv::d rvValidateItemProperties .
В следующих четырех примерах кода показаны следующие сценарии WIA_DPS_PAGE_SIZE:
Драйвер сообщает о параметрах.
Приложение задает для свойства WIA_DPS_PAGE_SIZE значение WIA_PAGE_LETTER.
Приложение задает для свойства WIA_IPS_ORIENTATION значение LANDSCAPE.
Приложение изменяет свойство WIA_IPS_XEXTENT на меньшее значение.
Пример 1. Мини-диск сообщает о параметрах
В следующем примере кода мини-диск устанавливает настраиваемую область выбора до того, как приложение задает свойства WIA. В этом случае область выбора представляет всю область с планшетом.
WIA_DPS_PAGE_SIZE = WIA_PAGE_CUSTOM WIA_DPS_PAGE_WIDTH = 11500 WIA_DPS_PAGE_HEIGHT = 14000 WIA_IPS_ORIENTATION = КНИЖНАЯ WIA_IPS_XPOS = 0 WIA_IPS_YPOS = 0 WIA_IPS_XEXTENT = 1150 WIA_IPS_YEXTENT = 1400 WIA_IPS_XRES = 100 WIA_IPS_YRES = 100
Пример 2. Приложение задает для свойства WIA_DPS_PAGE_SIZE значение WIA_PAGE_LETTER
WIA_DPS_PAGE_SIZE = WIA_PAGE_LETTER WIA_DPS_PAGE_WIDTH = 8500 WIA_DPS_PAGE_HEIGHT = 11000 WIA_IPS_ORIENTATION = КНИЖНАЯ WIA_IPS_XPOS = 0 WIA_IPS_YPOS = 0 WIA_IPS_XEXTENT = 850 WIA_IPS_YEXTENT = 1100 WIA_IPS_XRES = 100 WIA_IPS_YRES = 100
Пример 3. Приложение задает для свойства WIA_IPS_ORIENTATION значение LANDSCAPE
Физическая кровать должна иметь возможность получить страницу, которая изначально находилась в альбомной ориентации.
WIA_DPS_PAGE_SIZE = WIA_PAGE_LETTER WIA_DPS_PAGE_HEIGHT = 11000 WIA_DPS_PAGE_WIDTH = 8500 WIA_IPS_ORIENTATION = АЛЬБОМНАЯ WIA_IPS_XPOS = 0 WIA_IPS_YPOS = 0 WIA_IPS_XEXTENT = 1100 WIA_IPS_YEXTENT = 850 WIA_IPS_XRES = 100 WIA_IPS_YRES = 1000
Пример 4. Приложение изменяет свойство WIA_IPS_XEXTENT на меньшее значение
В следующем примере кода приложение изменяет свойство WIA_IPS_XEXTENT на 1000. Мини-диск должен предполагать, что новое значение WIA_IPS_XEXTENT больше не является допустимым для свойства WIA_DPS_PAGE_SIZE и поэтому должно изменить WIA_DPS_PAGE_SIZE на WIA_PAGE_CUSTOM. Мини-driver также должен настраивать WIA_DPS_PAGE_WIDTH.
WIA_DPS_PAGE_SIZE = WIA_PAGE_CUSTOM WIA_DPS_PAGE_HEIGHT = 10000 WIA_DPS_PAGE_WIDTH = 8500 WIA_IPS_ORIENTATION = АЛЬБОМНАЯ WIA_IPS_XPOS = 0 WIA_IPS_YPOS = 0 WIA_IPS_XEXTENT = 1000 WIA_IPS_YEXTENT = 850 WIA_IPS_XRES = 100 WIA_IPS_YRES = 1000
Требования
Версия: Устаревшее, используйте вместо него свойство WIA_IPS_PAGE_SIZE.
Заголовок: wiadef.h (включая Wiadef.h)