SetWindowLong函数介绍

SetWindowLong函数介绍

SetWindowLong Unicode 

函数原型 
LONG SetWindowLong(hwnd,nIndex,lNewLong) 
HWND hwnd; /* handle of window */ 
int nIndex; /* offset of value to set */ 
LONG lNewLong; /* new value */ 

函数说明 
SetWindowLong函数修改给定窗口的一个属性。该函数还在给定窗口的附加窗口内存中 
的指定偏移量处设置一个32位(长)值。 

参数详解 
hwnd 
标识窗口，并且间接标只出该窗口的属的窗口类。 

nIndex 
指定一个距离要设置的值的以0为基值的偏移量。有效的偏移量范围最小为0，最大为附 
加窗口内存的总字节数减为4，注：整数为四个字节；例如：若附加内存被指定为12个或 
更多个字节，值8将是第3个长整数的索引值。要设置其它值，则应指定下列值之一： 
值 动 作 
============================================================================ 
GWL_EXSTYLE 设置新的扩展窗口风格。 
GWL_STYLE 设置新的窗口风格 
GWL_WNDPROC 为窗口过程设置新地址。 
GWL_HINSTANCE 设置一个新的应用程序的实例句柄。 
GWL_ID 设置一人新的窗口标识符。 
GWL_USERDATA 设置与窗口相联系的长值。每个窗口都有一个供创建它的应用 
程序使用的与之对应的长值。 

当hwnd标识一个对话框时，还可使用下列值： 
值 含 义 
============================================================================ 
DWL_DLGPROC 设置对话框过程的新地址。 
DWL_MSGRESULT 设置对话框过程所处理的消息的返回值。 
DWL_USER 设置对应用程序来说是私有的新的附加信息：如句柄或打印机 
。 

lNewLong 
指定该替换值。 

返回值 
若函数成功，返回值是指定的32位整数的原值；否则，返回值为0。使用GetLastError 
函数可获取补充的错误信息。 

注释 
若使用SetWindowLong函数和GWL_WNDPROC索引替换窗口过程，则给定的窗口过程必须遵 
循WindowProc回调函数的说明中指定的准则。 
使用GWL_WNDPROC索引调用SetWindowLong函数可创建该窗口类的子类(窗口类用来创建窗 
口)。应用程序不得用另一个过程的窗口产生子类。 
使用RegisterClass函数，并将WNDCLASS结构的cbWndExtra成员指定为一个非零值，便可 
保留附加窗口内存。 
不得将SetWindowLong与GWL_HWNDPARENT索引一起使用来改变一个子窗口的父窗口。要 
改变子窗口的父窗口，应使用SetParent函数。