Nuta
Dostęp do tej strony wymaga autoryzacji. Możesz spróbować się zalogować lub zmienić katalog.
Dostęp do tej strony wymaga autoryzacji. Możesz spróbować zmienić katalogi.
Właściwość WIA_DPS_PAGE_SIZE zawiera rozmiar strony aktualnie wybranej do skanowania.
Typ właściwości: VT_I4
Prawidłowe wartości: WIA_PROP_LIST
Prawa dostępu: odczyt/zapis
Uwagi
Aby wybrać wymiary strony do skanowania, aplikacja ustawia WIA_DPS_PAGE_SIZE. Minidriver WIA tworzy i utrzymuje tę właściwość.
W poniższej tabeli opisano stałe, które są prawidłowe z WIA_IPS_PAGE_SIZE.
| Wartość | Definicja |
|---|---|
| WIA_PAGE_A4 | Rozmiar strony to 8267 × 11692 (orientacja PIONOWA). |
| WIA_PAGE_CUSTOM | Rozmiar strony jest definiowany przez wartości właściwości WIA_DPS_PAGE_HEIGHT i WIA_DPS_PAGE_WIDTH . |
| WIA_PAGE_LETTER | Rozmiar strony to 8500 × 11000 (orientacja pionowa). |
Wartość właściwości WIA_IPS_ORIENTATION określa orientację aktualnie wybranej strony. Właściwości WIA_DPS_PAGE_WIDTH i WIA_DPS_PAGE_HEIGHT raportują wymiary strony w tysiącach cala (.001). Te właściwości muszą mieć wartości równoważne właściwościom WIA_IPS_XEXTENT i WIA_IPS_YEXTENT , które zawierają wymiary strony w pikselach.
WIA_PROP_LIST typizowane wartości powinny zależeć od prawidłowych ustawień właściwości WIA_IPS_ORIENTATION. Jeśli urządzenie nie może skanować dokumentów zorientowanych na poziome przy użyciu ustawienia WIA_PAGE_A4, WIA_PAGE_A4 nie powinny być wyświetlane na liście prawidłowych wartości właściwości WIA_DPS_PAGE_SIZE, gdy WIA_IPS_ORIENTATION jest ustawiona na POZIOMO.
Jeśli aplikacja ustawi WIA_DPS_PAGE_SIZE na dowolną wartość inną niż WIA_PAGE_CUSTOM, minidriver powinien dostosować wartości WIA_DPS_PAGE_WIDTH i WIA_DPS_PAGE_HEIGHT do wymiarów strony, w tysiącach cala (.001). Minidriver powinien również dostosować wartości WIA_IPS_XEXTENT i WIA_IPS_YEXTENT do wymiarów strony w pikselach.
Jeśli ustawienie zakresu (WIA_IPS_XEXTENT lub WIA_IPS_YEXTENT) zostanie zmienione na wartość, która nie jest zgodna z bieżącym ustawieniem rozmiaru strony, minidriver powinien zmienić wartość właściwości WIA_DPS_PAGE_SIZE na WIA_PAGE_CUSTOM. Minidriver powinien również modyfikować WIA_DPS_PAGE_WIDTH lub WIA_DPS_PAGE_HEIGHT zgodnie z nowym ustawieniem zakresu.
Jeśli WIA_IPS_ORIENTATION jest ustawiona na POZIOMO, ustawienia zakresu będą "przerzucane". Jeśli na przykład aplikacja ustawia WIA_DPS_PAGE_SIZE na WIA_PAGE_A4, minidriver powinien ustawić WIA_DPS_PAGE_WIDTH na 11692 i WIA_DPS_PAGE_HEIGHT na 8267. (Minidriver powinien również odpowiednio ustawić WIA_IPS_XEXTENT i WIA_IPS_YEXTENT). Należy pamiętać, że jeśli WIA_DPS_PAGE_SIZE jest ustawiona na WIA_PAGE_CUSTOM, ustawienie orientacji nie jest używane do określania wymiarów zakresu strony do skanowania.
Minidriver musi upewnić się, że właściwość WIA_IPS_ORIENTATION zgadza się z bieżącym obszarem wyboru. Jeśli aplikacja zmieni wartość WIA_IPS_ORIENTATION na nieprawidłową dla aktualnie wybranego rozmiaru strony, minidriver powinien zmienić wartość WIA_DPS_PAGE_SIZE na rozmiar strony obsługiwany przez nową wartość orientacji.
Jeśli aplikacja ustawia właściwość WIA_DPS_PAGE_SIZE na WIA_PAGE_CUSTOM, bieżący obszar wyboru nie ma wpływu. Minidriver WIA powinien uzyskać bieżący układ obrazu, począwszy od bieżących ustawień właściwości WIA_IPS_XPOS i WIA_IPS_YPOS . Jeśli ustawienie rozmiaru strony powoduje wybranie obszaru poza łóżkiem skanera, minidriver musi automatycznie dostosować wartości WIA_IPS_XPOS i WIA_IPS_YPOS właściwości do prawidłowych ustawień. Jeśli właściwości WIA_DPS_PAGE_SIZE i WIA_IPS_ORIENTATION są ustawione w tym samym czasie i są nieprawidłowe, gdy są stosowane w połączeniu, minidriver powinien zakończyć się niepowodzeniem ustawień aplikacji, zwracając błąd w metodzie IWiaMiniDrv::d rvValidateItemProperties .
W poniższych czterech przykładach kodu przedstawiono następujące scenariusze WIA_DPS_PAGE_SIZE:
Sterownik zgłasza ustawienia.
Aplikacja ustawia właściwość WIA_DPS_PAGE_SIZE na WIA_PAGE_LETTER.
Aplikacja ustawia właściwość WIA_IPS_ORIENTATION na POZIOM.
Aplikacja zmienia właściwość WIA_IPS_XEXTENT na mniejszą wartość.
Przykład 1. Minidriver zgłasza ustawienia
W poniższym przykładzie kodu minidriver ustawia niestandardowy obszar wyboru przed ustawieniem przez aplikację dowolnych właściwości WIA. W tym przypadku obszar zaznaczenia reprezentuje całe płaskie.
WIA_DPS_PAGE_SIZE = WIA_PAGE_CUSTOM WIA_DPS_PAGE_WIDTH = 11500 WIA_DPS_PAGE_HEIGHT = 14000 WIA_IPS_ORIENTATION = portret WIA_IPS_XPOS = 0 WIA_IPS_YPOS = 0 WIA_IPS_XEXTENT = 1150 WIA_IPS_YEXTENT = 1400 WIA_IPS_XRES = 100 WIA_IPS_YRES = 100
Przykład 2. Aplikacja ustawia właściwość WIA_DPS_PAGE_SIZE na WIA_PAGE_LETTER
WIA_DPS_PAGE_SIZE = WIA_PAGE_LETTER WIA_DPS_PAGE_WIDTH = 8500 WIA_DPS_PAGE_HEIGHT = 11000 WIA_IPS_ORIENTATION = portret WIA_IPS_XPOS = 0 WIA_IPS_YPOS = 0 WIA_IPS_XEXTENT = 850 WIA_IPS_YEXTENT = 1100 WIA_IPS_XRES = 100 WIA_IPS_YRES = 100
Przykład 3. Aplikacja ustawia właściwość WIA_IPS_ORIENTATION na poziom
Fizyczne łóżko musi być zdolne do obsługi strony, która była pierwotnie w orientacji poziomej.
WIA_DPS_PAGE_SIZE = WIA_PAGE_LETTER WIA_DPS_PAGE_HEIGHT = 11000 WIA_DPS_PAGE_WIDTH = 8500 WIA_IPS_ORIENTATION = poziome WIA_IPS_XPOS = 0 WIA_IPS_YPOS = 0 WIA_IPS_XEXTENT = 1100 WIA_IPS_YEXTENT = 850 WIA_IPS_XRES = 100 WIA_IPS_YRES = 100
Przykład 4. Aplikacja zmienia właściwość WIA_IPS_XEXTENT na mniejszą wartość
W poniższym przykładzie kodu aplikacja zmienia właściwość WIA_IPS_XEXTENT na 1000. Minidriver powinien zakładać, że nowa wartość WIA_IPS_XEXTENT nie jest już prawidłowa dla właściwości WIA_DPS_PAGE_SIZE i dlatego powinna zmienić WIA_DPS_PAGE_SIZE na WIA_PAGE_CUSTOM. Minidriver musi również dostosować WIA_DPS_PAGE_WIDTH.
WIA_DPS_PAGE_SIZE = WIA_PAGE_CUSTOM WIA_DPS_PAGE_HEIGHT = 10000 WIA_DPS_PAGE_WIDTH = 8500 WIA_IPS_ORIENTATION = poziome WIA_IPS_XPOS = 0 WIA_IPS_YPOS = 0 WIA_IPS_XEXTENT = 1000 WIA_IPS_YEXTENT = 850 WIA_IPS_XRES = 100 WIA_IPS_YRES = 100
Wymagania
Wersja: Zamiast tego użyj właściwości WIA_IPS_PAGE_SIZE.
Nagłówek: wiadef.h (include Wiadef.h)