CreateDC

【勇芳软件工作室】汉化HomePreviousNext

CreateDC功能通过使用指定的名称为设备创建设备上下文(DC)。

HDC CreateDC(

LPCTSTR 【lpszDriver】,//指向驱动程序名称的字符串指针
LPCTSTR 【lpszDevice】,//指向设备名称的字符串指针
LPCTSTR 【lpszOutput】,// 不使用;设置为NULL
CONST DEVMODE *【lpInitData】//指向可选打印机数据的指针
); 

参数

【lpszDriver】

为早期版本的Windows编写的应用程序使用此参数指定设备驱动程序的文件名(无扩展名)。

Windows 95:在基于Win32的应用程序中,此参数将被忽略,并且应为NULL,但有一个例外:您可以通过指定以空值终止的字符串“DISPLAY”来获取显示设备上下文。如果此参数为“DISPLAY”,则所有其他参数必须为NULL。

指向一个空值终止的字符串,指定显示驱动程序的“DISPLAY”,或通常为“WINSPOOL”的打印机驱动程序的名称。

【lpszDevice】

指向一个空值终止的字符串,指定正在使用的特定输出设备的名称,如Print Manager(例如“Epson FX-80”)所示。它不是打印机型号名称。必须使用【lpszDevice】参数。

【lpszOutput】

此参数被忽略。不要在Win32应用程序中使用它。基于Win32的应用程序应将此参数设置为NULL。它存在于为早期版本的Windows编写的应用程序提供兼容性。有关详细信息,请参阅以下备注部分。

【lpInitData】

指向DEVMODE结构,其中包含设备驱动程序的特定于设备的初始化数据。DocumentProperties函数检索为指定设备填充的此结构。如果设备驱动程序要使用用户指定的默认初始化(如果有),则【lpInitData】参数必须为NULL。

返回值

如果函数成功,则返回值是指定设备的设备上下文的句柄。

如果函数失败,返回值为NULL。

备注

为早期版本的Windows编写的应用程序使用【lpszOutput】参数指定端口名称或打印到文件。基于Win32的应用程序不需要指定端口名称。通过使用DOCINFO结构lpszOutput成员指定输出文件名路径的StartDoc结构调用StartDoc函数,可以将基于Win32的应用程序打印到文件中。

当您不再需要设备上下文时,请调用DeleteDC功能将其删除。

也可以看看

DeleteDC, DEVMODE, DOCINFO, DocumentProperties, StartDoc