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_HEIGHT 和 WIA_DPS_PAGE_WIDTH 屬性的值所定義。 |
WIA_PAGE_LETTER | 頁面大小為 8500 × 11000 (PORTRAIT 方向) 。 |
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_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案例:
驅動程式會報告設定。
應用程式會將 WIA_DPS_PAGE_SIZE 屬性設定為 WIA_PAGE_LETTER。
應用程式會將 WIA_IPS_ORIENTATION 屬性設定為 LANDSCAPE。
應用程式會將 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)