共用方式為


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 (PORTRAIT 方向) 。
WIA_PAGE_CUSTOM 頁面大小是由 WIA_DPS_PAGE_HEIGHTWIA_DPS_PAGE_WIDTH 屬性的值所定義。
WIA_PAGE_LETTER 頁面大小為 8500 × 11000 (PORTRAIT 方向) 。

WIA_IPS_ORIENTATION屬性的值會決定目前選取頁面的方向。 WIA_DPS_PAGE_WIDTH和WIA_DPS_PAGE_HEIGHT屬性會以千分之一英吋 (.001) 來報告頁面的維度。 這些屬性的值必須相當於以圖元為單位的 WIA_IPS_XEXTENTWIA_IPS_YEXTENT 屬性,其中包含頁面的維度。

WIA_PROP_LIST類型的值應該取決於WIA_IPS_ORIENTATION屬性的有效設定。 如果裝置無法掃描具有WIA_PAGE_A4設定的橫向檔,當WIA_IPS_ORIENTATION設定為 LANDSCAPE 時,WIA_PAGE_A4不應該出現在WIA_DPS_PAGE_SIZE屬性的有效值清單中。

如果應用程式將WIA_DPS_PAGE_SIZE設定為WIA_PAGE_CUSTOM以外的任何值,minidriver 應該將WIA_DPS_PAGE_WIDTH的值和WIA_DPS_PAGE_HEIGHT調整為頁面維度的值,以千分之一英吋 (.001) 。 minidriver 也應該以圖元為單位,將WIA_IPS_XEXTENT和WIA_IPS_YEXTENT的值調整為頁面的維度。

如果範圍設定 (WIA_IPS_XEXTENT或WIA_IPS_YEXTENT) 變更為 不符合 目前頁面大小設定的值,minidriver 應該將 WIA_DPS_PAGE_SIZE 屬性的值變更為WIA_PAGE_CUSTOM。 minidriver 也應該根據新的範圍設定修改WIA_DPS_PAGE_WIDTH或WIA_DPS_PAGE_HEIGHT。

如果WIA_IPS_ORIENTATION設定為 LANDSCAPE,範圍設定將會「翻轉」。例如,如果應用程式將WIA_DPS_PAGE_SIZE設定為 WIA_PAGE_A4,minidriver 應該將WIA_DPS_PAGE_WIDTH設定為 11692,並將WIA_DPS_PAGE_HEIGHT設定為 8267。 (minidriver 也應該據以設定WIA_IPS_XEXTENT和WIA_IPS_YEXTENT。) 請注意,如果WIA_DPS_PAGE_SIZE設為 WIA_PAGE_CUSTOM,則方向設定不會用來判斷要掃描的頁面範圍維度。

minidriver 必須確保WIA_IPS_ORIENTATION屬性與目前的選取區域一致。 如果應用程式將WIA_IPS_ORIENTATION的值變更為目前所選頁面大小不正確值,minidriver 應該將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屬性,而且在結合套用屬性時無效,minidriver 應該傳回 IWiaMiniDrv::d rvValidateItemProperties 方法中的錯誤,讓應用程式的設定失敗。

下列四個程式碼範例顯示下列WIA_DPS_PAGE_SIZE案例:

  1. 驅動程式會報告設定。

  2. 應用程式會將 WIA_DPS_PAGE_SIZE 屬性設定為 WIA_PAGE_LETTER。

  3. 應用程式會將 WIA_IPS_ORIENTATION 屬性設定為 LANDSCAPE。

  4. 應用程式會將 WIA_IPS_XEXTENT 屬性變更為較小的值。

範例 1:迷你驅動程式會報告設定

在下列程式碼範例中,minidriver 會在應用程式設定任何 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。 minidriver 應該假設WIA_IPS_XEXTENT的新值不再對 WIA_DPS_PAGE_SIZE 屬性有效,因此應該將WIA_DPS_PAGE_SIZE變更為WIA_PAGE_CUSTOM。 minidriver 也必須調整 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

規格需求

版本: 過時,請改用 WIA_IPS_PAGE_SIZE 屬性。

標頭: wiadef.h (包含 Wiadef.h)

另請參閱

IWiaMiniDrv::d rvValidateItemProperties

WIA_DPS_PAGE_HEIGHT

WIA_DPS_PAGE_SIZE

WIA_DPS_PAGE_WIDTH

WIA_IPS_ORIENTATION

WIA_IPS_PAGE_SIZE

WIA_IPS_XEXTENT

WIA_IPS_XPOS

WIA_IPS_YEXTENT

WIA_IPS_YPOS