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 プロパティは、ページのサイズを 10000 インチ (.001) 単位で報告します。これらのプロパティには、ページのサイズを含む WIA_IPS_XEXTENT プロパティと WIA_IPS_YEXTENT プロパティに相当する値 (ピクセル単位) が必要です。

WIA_PROP_LIST型指定された値は、WIA_IPS_ORIENTATION プロパティの有効な設定に依存する必要があります。デバイスがWIA_PAGE_A4設定で横向きドキュメントをスキャンできない場合、WIA_PAGE_A4は、WIA_IPS_ORIENTATIONが LANDSCAPE に設定されているときに、WIA_DPS_PAGE_SIZE プロパティの有効な値の一覧に表示されません。

アプリケーションでWIA_DPS_PAGE_SIZEを WIA_PAGE_CUSTOM 以外の値に設定する場合、ミニドライバーは、ページのサイズ (10000 インチ ( .001) 単位) にWIA_DPS_PAGE_WIDTHとWIA_DPS_PAGE_HEIGHTの値を調整する必要があります。ミニドライバーは、ページのサイズに合わせて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が LANDSCAPE に設定されている場合、エクステントの設定は "反転" されます。たとえば、アプリケーションが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 プロパティが同時に設定されていて、組み合わせて適用すると無効な場合、ミニドライバーは IWiaMiniDrv::d rvValidateItemProperties メソッドでエラーを返すことによって、アプリケーションの設定を失敗させる必要があります。

次の 4 つのコード例は、次の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 = 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

例 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 = 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

例 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 = 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

例 4: アプリケーションが WIA_IPS_XEXTENT プロパティを小さい値に変更する

次のコード例では、アプリケーションが WIA_IPS_XEXTENT プロパティを 1000 に変更します。ミニドライバーは、WIA_IPS_XEXTENTの新しい値が WIA_DPS_PAGE_SIZE プロパティに対して有効ではなくなったと想定し、WIA_DPS_PAGE_SIZEをWIA_PAGE_CUSTOMに変更する必要があります。ミニドライバーも 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