描述
AdvancedDocumentProperties功能显示指定打印机的打印机配置对话框,允许用户配置该打印机。
此函数是DocumentProperties功能的特殊情况。有关详细信息,请参阅备注部分。
C++ 语法
LONG AdvancedDocumentProperties( __in HWND hWnd, __in HANDLE hPrinter, __in LPTSTR pDeviceName, __out PDEVMODE pDevModeOutput, __in PDEVMODE pDevModeInput ); |
PowerBASIC 语法
FUNCTION AdvancedDocumentPropertiesA ( _ BYVAL hWnd AS DWORD, _ BYVAL hPrinter AS DWORD, _ BYREF pDeviceName AS ASCIIZ, _ BYREF pDevModeOutput AS DEVMODEA, _ BYREF pDevModeInput AS DEVMODEA _ ) AS LONG |
Unicode版本:
FUNCTION AdvancedDocumentPropertiesW ( _ BYVAL hWnd AS DWORD, _ BYVAL hPrinter AS DWORD, _ BYREF pDeviceName AS WSTRINGZ, _ BYREF pDevModeOutput AS DEVMODEW, _ BYREF pDevModeInput AS DEVMODEW _ ) AS LONG |
参数
hWnd
[in]处理打印机配置对话框的父窗口。
hPrinter
[in]处理打印机对象。使用OpenPrinter或AddPrinter功能来检索打印机手柄。
pDeviceName
[in]指向指定要显示打印机配置对话框的设备名称的以null结尾的字符串的指针。
pDevModeOutput
[out]指向DEVMODE结构的指针,其中将包含用户指定的配置数据。
pDevModeInput
[in]指向DEVMODE结构的指针,其中包含用于初始化打印机配置对话框控件的配置数据。
返回值
如果具有这些参数的DocumentProperties功能成功,返回值为AdvancedDocumentProperties为1。否则返回值为零。
备注
此函数只能显示打印机配置对话框,以便用户可以对其进行配置。要进一步控制,请使用DocumentProperties.该函数的输入参数直接传递给DocumentProperties,fMode值设置为DM_IN_BUFFER或DM_IN_PROMPT或DM_OUT_BUFFER。与DocumentProperties不同,此函数仅返回1或0。因此,您无法通过将pDevMode设置为零来确定所需的大小DEVMODE.
应用程序可以通过调用GetPrinter函数获取pDeviceName参数指向的名称,然后检查PRINTER_INFO_2结构的pPrinterName成员。
Windows 95/98 / Me:Microsoft Layer for Unicode支持AdvancedDocumentPropertiesW.
引用文件 #INCLUDE Once
WinSpool.inc(包括Windows.inc)