DocumentProperties是一個靈活的印表機配置控制函式。
基本介紹
- 中文名：印表機配置控制函式
- 外文名：DocumentProperties
- VB聲明：一個靈活的印表機配置控制函式
- 返回值：Long
- 參數 類型：hwnd Long
簡介,說明,參數表,
簡介
DocumentProperties
VB聲明
Declare Function DocumentProperties& Lib "winspool.dll" Alias "DocumentPropertiesA" (ByVal hwnd As Long, ByVal hPrinter As Long, ByVal pDeviceName As String, ByVal pDevModeOutput As DEVMODE, ByVal pDevModeInput As DEVMODE, ByVal fMode As Long)
說明
該函式定義了兩個DEVMODE結構，可在創建一個設備場景時為單個應用程式改變印表機設定。甚至能在文檔列印期間改變印表機設定
返回值
Long，由fMode欄位的值決定。如下所示：
若fMode為零，這個函式就返回DEVMODE結構的尺寸。注意這個結構可能比類型定義檔案API32.TXT中規定的尺寸大
若fMode設定了DM_IN_PROMPT標誌，那么印表機設定對話框就會出現。在這種情況下，返回值將是常數IDOK 或 IDCANCEL——具體由用戶關閉對話框時按下的按鈕決定
在其他任何情況下，該函式執行成功後會返回IDOK。而在任何情況下，如函式執行失敗，都會返回一個負數。
參數表
參數 類型及說明
hwnd Long，對話框父視窗的句柄。這通常是當前的活動窗體
hPrinter Long，一個已打開的印表機對象的句柄
pDeviceName String，印表機的名字
pDevModeOutput Long，指向一個DEVMODE數據結構的指針。請參考DocumentProperties運行模式表。注意這個指針必須引用一個足夠大的緩衝區，它能同時容下專用印表機驅動程式數據，以及標準的DEVMODE結構
fMode Long，決定這個函式運作模式的一個標誌。請參考DocumentProperties運行模式表
DocumentProperties運行模式表
常數標誌 運行模式
無 不使用pDevModeInput。pDevModeOutput可能為零。函式會返回由這兩個參數引用的DEVMODE結構需要的大小
DM_IN_BUFFER pDevModeInput緩衝區應載入印表機驅動程式的新位置。在調用這個函式判斷應使用結構中的哪些欄位前，應設定結構的dmFields欄位
DM_IN_PROMPT 顯示出印表機設定對話框，以便用戶指定輸出時採用的印表機設定。如指定了DM_IN_BUFFER，那么在顯示對話框前，輸入緩衝區中指定的任何欄位都會與當前的印表機DEVMODE結構合併起來
DM_OUT_BUFFER 令印表機設定信息輸出到由pDevModeOutput參數指定的緩衝區。這些設定由兩個輸入標誌決定，而且由此反映了原始的輸入結構、當前的印表機設定以及用戶在印表機設定對話框中作出的任何修改。如未指定這個標誌，lpdmOutput參數就可以設為零
