WIA_DPS_PAGE_SIZE

Článek
2025-04-22

Vlastnost WIA_DPS_PAGE_SIZE obsahuje velikost stránky, která je aktuálně vybrána ke kontrole.

Typ vlastnosti: VT_I4

Platné hodnoty: WIA_PROP_LIST

Přístupová práva: Čtení a zápis

Poznámky

Pokud chcete vybrat rozměry stránky, které chcete zkontrolovat, nastaví aplikace WIA_DPS_PAGE_SIZE. Minidriver WIA vytvoří a udržuje tuto vlastnost.

Následující tabulka popisuje konstanty platné pro WIA_IPS_PAGE_SIZE.

Hodnota	Definice
WIA_PAGE_A4	Velikost stránky je 8267 × 11692 (orientace NA VÝŠKU).
WIA_PAGE_CUSTOM	Velikost stránky je definována hodnotami vlastností WIA_DPS_PAGE_HEIGHT a WIA_DPS_PAGE_WIDTH .
WIA_PAGE_LETTER	Velikost stránky je 8500 × 11000 (orientace NA VÝŠKU).

Hodnota vlastnosti WIA_IPS_ORIENTATION určuje orientaci aktuálně vybrané stránky. Vlastnosti WIA_DPS_PAGE_WIDTH a WIA_DPS_PAGE_HEIGHT hlásí rozměry stránky v tisících palce (.001). Tyto vlastnosti musí mít hodnoty, které jsou ekvivalentní WIA_IPS_XEXTENT a WIA_IPS_YEXTENT vlastnosti, které obsahují rozměry stránky v pixelech.

hodnoty typu WIA_PROP_LIST by měly záviset na platném nastavení vlastnosti WIA_IPS_ORIENTATION. Pokud zařízení nemůže prohledávat dokumenty orientované na šířku s nastavením WIA_PAGE_A4, WIA_PAGE_A4 by se nemělo zobrazovat v seznamu platných hodnot pro vlastnost WIA_DPS_PAGE_SIZE, pokud je WIA_IPS_ORIENTATION nastavena na ŠÍŘKU.

Pokud aplikace nastaví WIA_DPS_PAGE_SIZE na jinou hodnotu než WIA_PAGE_CUSTOM, minidriver by měl upravit hodnoty WIA_DPS_PAGE_WIDTH a WIA_DPS_PAGE_HEIGHT na rozměry stránky v tisících palce (,001). Minidriver by měl také upravit hodnoty WIA_IPS_XEXTENT a WIA_IPS_YEXTENT na rozměry stránky v pixelech.

Pokud se nastavení rozsahu (WIA_IPS_XEXTENT nebo WIA_IPS_YEXTENT) změní na hodnotu, která neodpovídá aktuálnímu nastavení velikosti stránky, měl by minidriver změnit hodnotu vlastnosti WIA_DPS_PAGE_SIZE na WIA_PAGE_CUSTOM. Minidriver by měl také upravit WIA_DPS_PAGE_WIDTH nebo WIA_DPS_PAGE_HEIGHT v souladu s novým nastavením rozsahu.

Pokud je WIA_IPS_ORIENTATION nastavená na ŠÍŘKU, nastavení rozsahu se překlopí. Pokud například aplikace nastaví WIA_DPS_PAGE_SIZE na WIA_PAGE_A4, měl by minidriver nastavit WIA_DPS_PAGE_WIDTH na 11692 a WIA_DPS_PAGE_HEIGHT na 8267. (Minidriver by měl také nastavit WIA_IPS_XEXTENT a WIA_IPS_YEXTENT odpovídajícím způsobem.) Všimněte si, že pokud je WIA_DPS_PAGE_SIZE nastavená na WIA_PAGE_CUSTOM, nastavení orientace se nepoužívá k určení rozměrů rozsahu stránky, které se mají zkontrolovat.

Minidriver musí zajistit, aby WIA_IPS_ORIENTATION vlastnost souhlasí s aktuální oblastí výběru. Pokud aplikace změní hodnotu WIA_IPS_ORIENTATION na hodnotu, která je pro aktuálně vybranou velikost stránky neplatná, měl by minidriver změnit hodnotu WIA_DPS_PAGE_SIZE na velikost stránky podporovanou novou hodnotou orientace.

Pokud aplikace nastaví vlastnost WIA_DPS_PAGE_SIZE na WIA_PAGE_CUSTOM, aktuální oblast výběru nebude ovlivněna. Minidriver WIA by měl získat aktuální rozložení obrázku počínaje aktuálním nastavením WIA_IPS_XPOS a WIA_IPS_YPOS vlastností. Pokud nastavení velikosti stránky vede k oblasti výběru, která je mimo postel skeneru, musí minidriver automaticky upravit hodnoty WIA_IPS_XPOS a WIA_IPS_YPOS vlastnosti na platné nastavení. Pokud jsou vlastnosti WIA_DPS_PAGE_SIZE a WIA_IPS_ORIENTATION nastaveny současně a jsou při použití v kombinaci neplatné, minidriver by měl selhat nastavení aplikace vrácením chyby v IWiaMiniDrv::d rvValidateItemProperties metody.

Následující čtyři příklady kódu ukazují následující WIA_DPS_PAGE_SIZE scénáře:

Ovladač hlásí nastavení.
Aplikace nastaví vlastnost WIA_DPS_PAGE_SIZE na WIA_PAGE_LETTER.
Aplikace nastaví vlastnost WIA_IPS_ORIENTATION na HODNOTU LANDSCAPE.
Aplikace změní vlastnost WIA_IPS_XEXTENT na menší hodnotu.

Příklad 1: Minidriver hlásí nastavení

V následujícím příkladu kódu minidriver nastaví vlastní oblast výběru dříve, než aplikace nastaví jakékoliv vlastnosti WIA. V tomto případě oblast výběru představuje celou plochou plochu.

WIA_DPS_PAGE_SIZE = WIA_PAGE_CUSTOM WIA_DPS_PAGE_WIDTH = 11500 WIA_DPS_PAGE_HEIGHT = 14000 WIA_IPS_ORIENTATION = NA WIA_IPS_XPOS VÝŠKU = 0 WIA_IPS_YPOS = 0 WIA_IPS_XEXTENT = 1150 WIA_IPS_YEXTENT = 1400 WIA_IPS_XRES = 100 WIA_IPS_YRES = 100

Příklad 2: Aplikace nastaví vlastnost 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 = NA VÝŠKU WIA_IPS_XPOS = 0 WIA_IPS_YPOS = 0 WIA_IPS_XEXTENT = 850 WIA_IPS_YEXTENT = 1100 WIA_IPS_XRES = 100 WIA_IPS_YRES = 100

Příklad 3: Aplikace nastaví vlastnost WIA_IPS_ORIENTATION na HODNOTU LANDSCAPE.

Fyzická postel musí být schopna získat stránku, která byla původně v orientaci na šířku.

WIA_DPS_PAGE_SIZE = WIA_PAGE_LETTER WIA_DPS_PAGE_HEIGHT = 11000 WIA_DPS_PAGE_WIDTH = 8500 WIA_IPS_ORIENTATION = NA ŠÍŘKU WIA_IPS_XPOS = 0 WIA_IPS_YPOS = 0 WIA_IPS_XEXTENT = 1100 WIA_IPS_YEXTENT = 850 WIA_IPS_XRES = 100 WIA_IPS_YRES = 100

Příklad 4: Aplikace změní vlastnost WIA_IPS_XEXTENT na menší hodnotu.

V následujícím příkladu kódu aplikace změní vlastnost WIA_IPS_XEXTENT na 1000. Minidriver by měl předpokládat, že nová hodnota pro WIA_IPS_XEXTENT už není platná pro vlastnost WIA_DPS_PAGE_SIZE a měla by tedy změnit WIA_DPS_PAGE_SIZE na WIA_PAGE_CUSTOM. Minidriver musí také upravit WIA_DPS_PAGE_WIDTH.

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