勇芳软件工作室.汉化:  Printing > Print Spooler API > Print Spooler API Reference > Print Spooler API Functions >

AdvancedDocumentProperties

Previous pageReturn to chapter overviewNext page

描述

 

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]处理打印机对象。使用OpenPrinterAddPrinter功能来检索打印机手柄。

 

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)