DocumentProperties

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結構

pDevModeInput Long，指向一個DEVMODE數據結構的指針。請參考DocumentProperties運行模式表

fMode Long，決定這個函數運作模式的一個標誌。請參考DocumentProperties運行模式表

DocumentProperties運行模式表

常數標誌 運行模式

無 不使用pDevModeInput。pDevModeOutput可能為零。函數會返回由這兩個參數引用的DEVMODE結構需要的大小

DM_IN_BUFFER pDevModeInput緩衝區應載入打印機驅動程序的新位置。在調用這個函數判斷應使用結構中的哪些字段前，應設置結構的dmFields字段

DM_IN_PROMPT 顯示出打印機設置對話框，以便用户指定輸出時採用的打印機設置。如指定了DM_IN_BUFFER，那麼在顯示對話框前，輸入緩衝區中指定的任何字段都會與當前的打印機DEVMODE結構合併起來

DM_OUT_BUFFER 令打印機設置信息輸出到由pDevModeOutput參數指定的緩衝區。這些設置由兩個輸入標誌決定，而且由此反映了原始的輸入結構、當前的打印機設置以及用户在打印機設置對話框中作出的任何修改。如未指定這個標誌，lpdmOutput參數就可以設為零