• 1.摘要
  • 2.语法结构
  • 3.函数参数
  • 3.1.hWnd
  • 3.2.nlndex
  • 4.返回值
  • 5.函数备注
  • 6.版本需求

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。