SetWindowLong是一个Windows API函数。该函数用来改变指定窗口的属性.函数也将指定的一个32位值设置在窗口的额外
存储空间的指定
偏移位置。
函数原型
参数
hWnd
nlndex
指定将设定的
大于等于0的偏移值。有效值的范围从0到额外类的存储空间的字节数减4:例如若指定了12或多于12个字节的额外窗口存储空间,则应设索引位8来访问第三个4字节,同样设置0访问第一个4字节,4访问第二个4字节。要设置其他任何值,可以指定下面值之一:
当hWnd参数标识了一个对话框时,也可使用下列值:
dwNewLong
指定的替换值。
dwNewLong中可以使用以下一些列表控件的专用风格:
LVS_
ICON LVS_SMALLICON LVS_LIST LVS_REPORT
这四种风格决定控件的外观,同时只可以选择其中一种,分别对应:
大图标显示,小图标显示,列表显示,详细报表显示
LVS_EDITLABELS 结点的显示字符可以被编辑,对于报表风格来讲可编辑的只为第一列。
LVS_SHOWSELALWAYS 在失去焦点时也显示当前选中的结点
LVS_SINGLESEL 同时只能选中列表中一项
返回值
如果函数成功,
返回值是指定的32位整数的原来的值。如果函数失败,返回值为0。若想获得更多
错误信息,请调用GetLast
Error函数。
如果指定32位整数的原来的值为0,并且函数成功,则返回值为0,但是函数并不清除最后的错误信息,这就很难判断函数是否成功。这时,就应在调用SetWindowLong之前调用SetLastError(0)函数来清除最后的错误信息。这样,如果函数失败就会返回0,并且
GetLastError。也返回一个
非零值。
其他信息
如果由hWnd参数指定的窗口与调用线程不属于同一进程,将导致SetWindowLong函数修改窗口过程失败。
指定的窗口数据是在缓存中保存的,因此在调用SetWindowLong之后再调用
SetWindowPos函数才能使SetWindowLong函数所作的改变生效。
如果使用带GWL_WNDPROC索引值的SetWindowLong函数替换窗口过程,则该窗口过程必须与WindowProccallback函数说明部分指定的指导行一致。
如果使用带DWL_MSGRESULT索引值的SetWindowLong函数来设置由一个对话框过程处理的消息的返回值,应在此后立即返回TRUE。否则,如果又调用了其他函数而使对话框过程接收到一个窗口消息,则嵌套的窗口消息可能改写使用DWL_MSGRESULT设定的返回值。
可以使用带GWL_WNDPROC索引值的SetWindowLong函数创建一个
窗口类的
子类,该窗口类是用于创建该窗口的类。一个应用程序可以以一个系统类为子类,但是不能以一个其他进程产生的窗口类为子类,SetwindowLong函数通过改变与一个特殊的窗口类相联系的窗口过程来创建窗口子类,从而使
系统调用新的窗口过程而不是以前定义的窗口过程。应用程序必须通过调用
CallWindowProc函数向前窗口传递未被新窗口处理的消息,这样作允许应用程序创建一个窗口过程链。
通过
使用函数RegisterClassEx将结构
WNDCLASSEX中的cbWndExtra单元指定为一个非0值来保留新外窗口内存。
不能通过调用带GWL_HWNDPARENT索引值的SetWindowLong的函数来改变子窗口的父窗口,应使用
SetParent函数。
Windows CE:nlndex参数必须是4个字节的倍数不支持
unaligned access。
不支持下列nlndex参数值
GWL_HINSTANCE;GWL_HWNDPARENTGWL;GWL_USERDATA
Windows CE 2.0版支持在nlndex参数中的DWL_DLGPROC值,但是WindowsCE1.0不支持。
需求
头文件:winuser.h;
库文件:user32.lib;Unicode:在
Windows NT上实现为ANSI和Unicode两种版本。
其它函数
函数功能:该函数删除一个
窗口类,清空该类所需的内存。
函数原型:BOOL UnregisterClass(
LPCTSTR Ip
ClassName;
HINSTANCE hlnstance);
参数:
IpClassName:指向一个空结束
字符串的指针,或是一个
整型原子。如果IpClassName是一个字符串,则它指定了
窗口类的类名。这个类名必须由此前调用RegisterClassEx函数来注册。系统类,如对话框控制,必须被注册。
如果这个参数是一个整型原子,它必须是由此前调用GlobalAdd原子函数创建的
全局原子。这个16位整型数小于OxCOOO,必须是lpszClass的低16位,其高位宇必须为0。
hlnstance:创建类的模块的实例句柄。
返回值:如果函数成功,返回值为非零;如果
未发现类或由此类创建的窗口仍然存在,则返回值为0。
若想获得更多错误信息,请调用GetLastError函数。
备注:在调用这个函数之前,
应用程序必须销毁由指定类创建的所有窗口。
应用程序注册的所有
窗口类在应用程序中止后都为未注册的类。
Windows 95:所有由OLL注册的窗口类在DLL卸载后均未注册的类。
windows NT:所有由DLL注册的类在DLL卸载后仍为已注册的类。
速查:Windows NT:3.1以上版本;Windows:95以上版本;Windows CE:1.0以上版本;头文件:winuser.h;库文件:user32.lib;Unicode:在Windows NT上实现为Uhicode和ANSI两种版本。