getwindowlong
GetWindowLong是一个Windows API函数,获得指定窗口的有关信息,也获得在额外窗口内存中指定偏移位地址的32位度整型值。
语法结构
LONGGetWindowLong(HWNDhWnd,intnlndex);
函数参数
hWnd
目标窗口的句柄。
它可以是窗口句柄及间接给出的窗口所属的窗口类。
nlndex
需要获得的相关信息的类型。
指定要获得值的大于等于0的值的偏移量。有效值的范围从0到额外窗口内存空间的字节数一4例如,若指定了12位或多于12位的额外类存储空间,则应设为第三个32位整数的索引位8。要获得任意其他值,指定下列值之一:
值 | 意义 |
|---|---|
GWL_EXSTYLE (-20) | 获得扩展窗口风格。 |
GWL_HINSTANCE (-6) | 获得应用实例的句柄。 |
GWL_HWNDPARENT (-8) | 如果父窗口存在,获得父窗口句柄。 |
GWL_ID (-12) | 获得窗口标识。 |
GWL_STYLE (-16) | 获得窗口风格。 |
hWnd参数为对话框句柄时,还可用下列值:
值 | 意义 |
|---|---|
DWL_DLGPROC (4) | 获得对话框过程的地址,或一个代表对话框过程的地址的句柄。必须使用函数CallWindowProc来调用对话框过程。 |
DWL_MSGRESULT (0) | 获得在对话框过程中一个消息处理的返回值。 |
DWL_USER (8) | 获得应用程序私有的额外信息,例如一个句柄或指针。 |
返回值
如果函数成功,返回值是所需的32位值;如果函数失败,返回值是0。若想获得更多错误信息请调用 GetLastError函数。
函数备注
通过使用函数RegisterClassEx将结构WNDCLASSEX中的cbWndExtra单元指定为一个非0值来保留额外类的存储空间。
Windows CE:nlndex参数指定的字节偏移量必须为 4的倍数。不支持 unaligmned access。
Windows CE:不支持在参数nlndex中设定的GWL_HINSTANCE和GWL_HWNDPARENT。
Windows CE1.0也不支持在 nlndex参数中的 DWL_DLGPROC和 GWL_USERDATA。