窗口句柄及间接给出的窗口所属的类。
指定将设定的大于等于0的偏移值。有效值的范围从0到额外类的存储空间的字节数减4:例如若指定了12或多于12个字节的额外窗口存储空间,则应设索引位8来访问第三个4字节,同样设置0访问第一个4字节,4访问第二个4字节。要设置其他任何值,可以指定下面值之一:
常量 | 常量值 | 意义 |
---|---|---|
GWL_EXSTYLE | -20 | 设定一个新的扩展风格 |
GWL_HINSTANCE | -6 | 设置一个新的应用程序实例句柄 |
GWL_ID | -12 | 设置一个新的窗口,标识符 |
GWL_STYLE | -16 | 设定一个新的窗口风格 |
GWL_USERDATA | -21 | 设置与窗口有关的32位值。每个窗口均有一个由创建该窗口的应用程序使用的32位值。 |
GWL_WNDPROC | -4 | 为窗口过程设定一个新的地址 |
当hWnd参数标识了一个对话框时,也可使用下列值:
常量 | 常量值 | 意义 |
---|---|---|
DWL_DLGPROC | DWLP_MSGRESULT,+,sizeof(LRESULT) | 设置对话框过程的新地址 |
DWL_MSGRESULT | 0 | 设置在对话框过程中处理的消息的,返回值 |
DWL_USER | DWLP_DLGPROC,+,sizeof(DLGPROC) | 设置的应用程序私有的新的额外信息,例如一个句柄或指针 |
指定的替换值。
dwNewLong中可以使用以下一些列表控件的专用风格:
LVS_ICON LVS_SMALLICON LVS_LIST LVS_REPORT
这四种风格决定控件的外观,同时只可以选择其中一种,
大图标显示,小图标显示,列表显示,
LVS_EDITLABELS 结点的显示字符可以被编辑,对于报表风格来讲可编辑的只为第一列。
LVS_SHOWSELALWAYS 在失去焦点时也显示当前选中的结点
LVS_SINGLESEL 同时只能选中列表中一项
如果函数成功,返回值是指定的32位整数的原来的值。如果函数失败,返回值为0。若想获得更多错误信息,请调用GetLastError函数。
如果指定32位整数的原来的值为0,并且函数成功,则返回值为0,但是函数并不清除最后的错误信息,这就很难判断函数是否成功。这时,就应在调用SetWindowLong之前调用callingSetLastError(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不支持。
DLL最低版本 | user32.dll |
---|---|
头文件 | 在Winuser.h中声明,包含于Windows.h |
库文件 | User32.lib |
操作系统最低版本 | Windows,95,Windows,NT,3,1 |
ANSI和Unicode的API名 | SetWindowLongA (ANSI)和SetWindowLongW (Unicode) |
速查:Windows NT 3.1以上版本;Windows 95以上版本;Windows CE 1.0以上版本;
头文件:winuser.h;库文件:user32.lib;Unicode:在Windows NT上实现为ANSI和Unicode两种版本。
UnRegisterClass函数
函数功能:该函数删除一个窗口类,清空该类所需的内存。
函数原型:BOOL UnRegisterClass(LPCTSTR IpClassName; 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两种版本。
本API在VB中的使用方法: Private Declare Function SetClassLong Lib "user32.dll" Alias "SetClassLongA" ( _ ByVal hwnd As Long, _ ByVal nIndex As Long, _ ByVal dwNewLong As Long _ ) As Long Private Declare Function SetWindowLong Lib "user32.dll" Alias "SetWindowLongA" ( _ ByVal hwnd As Long, _ ByVal nIndex As Long, _ ByVal dwNewLong As Long _ ) As Long Private Const GCL_STYLE As Long = -26& Private Const GWL_STYLE As Long = -16& Private Const GWL_EXSTYLE As Long = -20& Private Sub Form_Load() SetClassLong hwnd, GCL_STYLE, 0& SetWindowLong hwnd, GWL_STYLE, 0& SetWindowLong hwnd, GWL_EXSTYLE, 0& Hide Show DoEvents End End Sub