pub fn get_window_long(h_wnd: HWND, n_index: WINDOW_LONG_PTR_INDEX) -> i32Expand description
查询有关指定窗口的信息。该函数还会在指定偏移量处查询 32 位 (DWORD) 值,并将其查询到额外的窗口内存中。
注意如果要查询指针或句柄,则此函数已被 get_window_long_ptr 函数取代。(指针和手柄在 32 位 Windows 上为 32 位,在 64 位 Windows 上为 64 位。要编写与 32 位和 64 位版本的 Windows 兼容的代码,请使用 get_window_long_ptr。
如果函数成功,则返回值为请求的值。
如果函数失败,则返回值为零。要获取扩展错误信息,请调用 get_last_error。
如果之前未调用 set_window_long,则 get_window_long 为额外窗口或类内存中的值返回零。
通过在 与 register_class_ex 函数一起使用的 WNDCLASSEX 结构的 cbWndExtra 成员中指定非零值来保留额外的窗口内存。
h_wnd 窗口的句柄,间接地,窗口所属的类。
n_index 要查询的值的从 0 开始的偏移量。有效值的范围是 0 到额外窗口内存的字节数减去 4;例如,如果指定了 12 个字节或更多字节的额外内存,则值 8 将是第三个 32 位整数的索引。要查询任何其他值,请指定以下值之一。
值 | 意义
GWL_EXSTYLE -20 | 查询扩展窗口样式。
GWL_HINSTANCE -6 | 查询应用程序实例的句柄。
GWL_HWNDPARENT -8 | 查询父窗口的句柄(如果有)。
GWL_ID -12 | 查询窗口的标识符。
GWL_STYLE -16 | 查询窗口样式。
GWL_USERDATA -21 | 查询与窗口关联的用户数据。此数据供创建窗口的应用程序使用。它的值最初为零。
GWL_WNDPROC -4 | 查询窗口过程的地址,或表示窗口过程地址的句柄。必须使用 call_window_proc 函数调用窗口过程。
当 h_wnd 参数标识对话框时,以下值也可用。
值 | 意义
DWL_DLGPROC DWLP_MSGRESULT + sizeof(LRESULT) | 查询对话框过程的地址,或表示对话框过程地址的句柄。必须使用 CallWindowProc 函数调用对话框过程。
DWL_MSGRESULT 0 | 查询在对话框过程中处理的消息的返回值。
DWL_USER DWLP_DLGPROC + sizeof (DLGPROC) | 查询应用程序专用的额外信息,例如句柄或指针。