勇芳软件工作室.汉化:  Painting and Drawing > Painting and Drawing Functions >

GetWindowDC

Previous pageReturn to chapter overviewNext page

描述

 

GetWindowDC函数检索整个窗口的设备上下文(DC),包括标题栏,菜单和滚动条。窗口设备上下文允许在窗口中的任何地方进行绘制,因为设备上下文的原点是窗口的左上角而不是客户区。

 

GetWindowDC在每次检索设备上下文时都将默认属性分配给窗口设备上下文。以前的属性丢失。

 

C++ 语法

 

HDC GetWindowDC(

__in HWND hWnd

);

 

PowerBASIC 语法

 

FUNCTION GetWindowDC ( _

BYVAL hdc AS DWORD _

) AS DWORD

 

参数

 

hdc

 

[in]使用要检索的设备上下文处理窗口。如果此值为NULL,则GetWindowDC检索整个屏幕的设备上下文。

 

Windows 98 / Me,Windows 2000 / XP / Vista / Windows 7:如果此参数为NULL,则GetWindowDC检索主显示器的设备上下文。要获取其他显示器的设备上下文,请使用EnumDisplayMonitorsCreateDC功能。

 

返回值

 

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

 

如果函数失败,返回值为NULL,表示错误或无效的的hWnd参数。

 

备注

 

GetWindowDC旨在在窗口的非客户区内进行特殊的绘画效果。不建议在任何窗口的非临时区域绘画。

 

GetSystemMetrics功能可用于检索非客户区域各个部分的尺寸,例如标题栏,菜单和滚动条。

 

GetDC功能可用于检索整个屏幕的设备上下文。

 

绘画完成后,必须调用ReleaseDC函数来释放设备上下文。不释放窗口设备上下文对应用程序请求的绘画有严重影响。

 

引用文件 #INCLUDE Once

 

WinUser.inc(包括Windows.inc)