SetWindowLongA 函数 (winuser.h)
更改指定窗口的属性。 该函数还将 32 位 (长) 值设置为额外的窗口内存中的指定偏移量。
语法
LONG SetWindowLongA(
[in] HWND hWnd,
[in] int nIndex,
[in] LONG dwNewLong
);
参数
[in] hWnd
类型：HWND
窗口的句柄，间接地是窗口所属的类。
[in] nIndex
类型： int
要设置的值的从零开始的偏移量。 有效值的范围为零到额外窗口内存的字节数，减去整数的大小。 若要设置任何其他值，请指定以下值之一。
| Value | 含义 |
|---|---|
|
设置新的 扩展窗口样式。 |
|
设置新的应用程序实例句柄。 |
|
设置子窗口的新标识符。 该窗口不能是顶级窗口。 |
|
设置新的 窗口样式。 |
|
设置与窗口关联的用户数据。 此数据供创建窗口的应用程序使用。 其值最初为零。 |
|
设置窗口过程的新地址。
如果窗口不属于与调用线程相同的进程，则无法更改此属性。 |
当 hWnd 参数标识对话框时，还可以使用以下值。
| Value | 含义 |
|---|---|
|
设置对话框过程的新地址。 |
|
设置对话框中处理的消息的返回值。 |
|
设置应用程序专用的新额外信息，例如句柄或指针。 |
[in] dwNewLong
类型： LONG
替换值。
返回值
类型： LONG
如果函数成功，则返回值是指定 32 位整数的上一个值。
如果函数失败，则返回值为零。 要获得更多的错误信息，请调用 GetLastError。
如果指定的 32 位整数的上一个值为零，并且函数成功，则返回值为零，但该函数未清除最后的错误信息。 这使得很难确定成功或失败。 若要解决此问题，应在调用 SetWindowLong 之前先调用 SetLastError 来清除最后一个错误信息。 然后，函数失败将由零的返回值和非零的 GetLastError 结果指示。
注解
缓存某些窗口数据，因此在使用 SetWindowLong 进行的更改在调用 SetWindowPos 函数之前不会生效。 具体而言，如果更改任何框架样式，则必须使用SWP_FRAMECHANGED标志调用 SetWindowPos，以便正确更新缓存。
如果使用 SetWindowLong 和 GWL_WNDPROC 索引替换窗口过程，则窗口过程必须符合 WindowProc 回调函数说明中指定的准则。
如果将 SetWindowLong 与 DWL_MSGRESULT 索引配合使用来设置对话框过程处理的消息的返回值，则应在之后直接返回 TRUE 。 否则，如果调用任何导致对话过程收到窗口消息的函数，则嵌套窗口消息可能会覆盖使用 DWL_MSGRESULT设置的返回值。
使用 GWL_WNDPROC索引调用 SetWindowLong 将创建用于创建窗口的窗口类的子类。 应用程序可以对系统类进行子类化，但不应将窗口类归为由另一个进程创建的窗口类。 SetWindowLong 函数通过更改与特定窗口类关联的窗口过程来创建窗口子类，导致系统调用新窗口过程而不是上一个窗口过程。 应用程序必须通过调用 CallWindowProc 将新窗口过程未处理的任何消息传递给以前的窗口过程。 这样，应用程序就可以创建窗口过程链。
通过在与 RegisterClassEx 函数一起使用的 WNDCLASSEX 结构的 cbWndExtra 成员中指定非零值来保留额外的窗口内存。
不得使用 GWL_HWNDPARENT 索引调用 SetWindowLong 以更改子窗口的父窗口。 请改用 SetParent 函数。
如果窗口的类样式为CS_CLASSDC或CS_OWNDC，请不要WS_EX_COMPOSITED或WS_EX_LAYERED设置扩展窗口样式。
调用 SetWindowLong 设置进度栏上的样式将重置其位置。
示例
有关示例，请参阅 子类化窗口。
注意
winuser.h 标头将 SetWindowLong 定义为别名，该别名根据 UNICODE 预处理器常量的定义自动选择此函数的 ANSI 或 Unicode 版本。 将非中性编码别名与非编码中性代码混合使用可能会导致编译或运行时错误不匹配。 有关详细信息，请参阅 函数原型的约定。
要求
| 最低受支持的客户端 | Windows 2000 Professional [仅限桌面应用] |
| 最低受支持的服务器 | Windows 2000 Server [仅限桌面应用] |
| 目标平台 | Windows |
| 标头 | winuser.h (包括 Windows.h) |
| Library | User32.lib |
| DLL | User32.dll |
| API 集 | 在 Windows 8) 中引入的 ext-ms-win-ntuser-windowclass-l1-1-0 ( |
另请参阅
概念性
参考