炫彩WinApi类

func DispatchMessage ¶

func DispatchMessage(pMsg *MSG) int

DispatchMessage 向窗口过程发送消息。它通常用于发送由 GetMessage 函数检索到的消息。

@Description: https://docs.microsoft.com/zh-cn/windows/win32/api/winuser/nf-winuser-DispatchMessageW.
@param pMsg 指向包含消息的结构的指针。
@return int 返回值指定窗口过程返回的值。尽管它的含义取决于所发送的消息，但返回值通常会被忽略。

func DragFinish ¶

func DragFinish(hDrop uintptr)

DragFinish 释放系统分配用于将文件名传输到应用程序的内存.

@Description 详见: https://docs.microsoft.com/en-us/windows/win32/api/shellapi/nf-shellapi-DragFinish.
@param hDrop 句柄.

func GetMessage ¶

func GetMessage(pMsg *MSG, hWnd uintptr, wMsgFilterMin uint32, wMsgFilterMax uint32) int32

GetMessage 从调用线程的消息队列中检索消息。应用程序通常使用返回值来确定是否结束主消息循环并退出程序。该函数分派传入的已发送消息，直到发布的消息可用于检索。 与 GetMessage 不同， PeekMessage 函数在返回之前不会等待消息发布。

@Description: https://docs.microsoft.com/zh-cn/windows/win32/api/winuser/nf-winuser-GetMessageW.
@param pMsg 指向从线程的消息队列接收消息信息的 MSG 结构的指针。
@param hWnd 要检索其消息的窗口的句柄。窗口必须属于当前线程。如果hWnd为0， GetMessage 检索属于当前线程的任何窗口的消息，以及当前线程的消息队列中hwnd值为0的任何消息（参见 MSG 结构）。因此，如果hWnd为0，则同时处理窗口消息和线程消息。如果hWnd为-1， GetMessage 仅检索当前线程的消息队列中hwnd值为0的消息，即 PostMessage （当hWnd参数为0时）或 PostThreadMessage 发布的线程消息。
@param wMsgFilterMin 要检索的最低消息值的整数值。使用WM_KEYFIRST (0x0100) 指定第一条键盘消息或WM_MOUSEFIRST (0x0200) 指定第一条鼠标消息。
@param wMsgFilterMax 要检索的最高消息值的整数值。使用WM_KEYLAST指定最后一个键盘消息或WM_MOUSELAST指定最后一个鼠标消息。
@return int32 如果函数检索到 WM_QUIT 以外的消息，则返回值非零。如果函数检索到 WM_QUIT 消息，则返回值为零。如果有错误，返回值为-1。

func RegisterWindowMessageW ¶

func RegisterWindowMessageW(lpString string) int

RegisterWindowMessageW 定义保证在整个系统中唯一的新窗口消息。 发送或发布消息时可以使用消息值.

详见: https://learn.microsoft.com/zh-cn/windows/win32/api/winuser/nf-winuser-RegisterWindowMessageW.
@param lpString 要注册的消息。
@return int 如果成功注册消息，则返回值是范围0xC000到0xFFFF的消息标识符. 如果函数失败，则返回值为零.

func TranslateMessage ¶

func TranslateMessage(pMsg *MSG) bool

TranslateMessage 将虚拟键消息转换为字符消息。字符消息被发布到调用线程的消息队列中，以便在线程下次调用 GetMessage 或 PeekMessage 函数时读取。

@Description: https://docs.microsoft.com/zh-cn/windows/win32/api/winuser/nf-winuser-TranslateMessage.
@param pMsg 一个指向 MSG 结构的指针，该结构包含使用 GetMessage 或 PeekMessage 函数从调用线程的消息队列中检索到的消息信息。
@return bool

func XCloseHandle ¶

func XCloseHandle(对象句柄 uintptr) bool

CloseHandle 关闭一个内核对象.

详情: https://learn.microsoft.com/zh-cn/windows/win32/api/handleapi/nf-handleapi-closehandle.
@param handle 对象句柄.
@return int

func X全局内存分配 ¶

func X全局内存分配(内存分配属性 GMEM_, 字节数 uint) uintptr

GlobalAlloc 从堆中分配指定数量的字节.

@Description 详情: https://docs.microsoft.com/zh-cn/windows/win32/api/winbase/nf-winbase-GlobalAlloc.
@param uFlags 内存分配属性。如果指定为零，则默认为 GMEM_Fixed. 该参数可以是以下值中的一个或多个: wapi.GMEM_ .
@param dwBytes 要分配的字节数。如果此参数为0并且uFlags参数指定 GMEM_Moveable ，则该函数返回标记为已丢弃的内存对象的句柄.
@return uintptr 如果函数成功，则返回值是新分配的内存对象的句柄. 如果函数失败，则返回值为NULL.

func X全局内存对象关闭 ¶

func X全局内存对象关闭(内存对象句柄 uintptr) uintptr

GlobalFree 释放指定的全局内存对象并使其句柄无效.

@Description 详情: https://docs.microsoft.com/zh-cn/windows/win32/api/winbase/nf-winbase-GlobalFree.
@param hMem 全局内存对象的句柄. 此句柄由 GlobalAlloc 或 GlobalReAlloc 函数返回. 释放使用 LocalAlloc 分配的内存是不安全的.
@return uintptr 如果函数成功, 则返回值为NULL. 如果函数失败, 则返回值等于全局内存对象的句柄.

func X全局内存对象取大小 ¶

func X全局内存对象取大小(内存对象句柄 uintptr) uint

GlobalSize 检索指定全局内存对象的当前大小，以字节为单位.

@Description 内存块的大小可能大于分配内存时请求的大小. 要验证指定对象的内存块是否未被丢弃, 请在调用 GlobalSize 之前使用 GlobalFlags 函数.
详情: https://docs.microsoft.com/zh-cn/windows/win32/api/winbase/nf-winbase-GlobalSize.
@param hMem 全局内存对象的句柄。此句柄由 GlobalAlloc 或 GlobalReAlloc 函数返回.
@return uint64 如果函数成功，则返回值是指定全局内存对象的大小，以字节为单位. 如果指定的句柄无效或对象已被丢弃，则返回值为0.

func X全局内存对象解锁 ¶

func X全局内存对象解锁(内存对象句柄 uintptr) bool

GlobalUnlock 减少与使用 GMEM_Moveable 分配的内存对象关联的锁计数。此函数对使用 GMEM_Fixed 分配的内存对象没有影响.

@Description 详情: https://docs.microsoft.com/zh-cn/windows/win32/api/winbase/nf-winbase-GlobalUnlock.
@param hMem 全局内存对象的句柄。此句柄由 GlobalAlloc 或 GlobalReAlloc 函数返回.
@return bool

func X全局内存对象锁定 ¶

func X全局内存对象锁定(内存对象句柄 uintptr) uintptr

GlobalLock 锁定一个全局内存对象并返回一个指向对象内存块第一个字节的指针.

@Description 详情: https://docs.microsoft.com/zh-cn/windows/win32/api/winbase/nf-winbase-GlobalLock.
@param hMem 全局内存对象的句柄。此句柄由 GlobalAlloc 或 GlobalReAlloc 函数返回.
@return uintptr 如果函数成功，则返回值是指向内存块第一个字节的指针. 如果函数失败，则返回值为NULL.

func X内存复制 ¶

func X内存复制(目标内存块指针 uintptr, 源内存块指针 uintptr, 字节数 uint)

RtlMoveMemory 将源内存块的内容复制到目标内存块，并支持重叠的源内存块和目标内存块.

@Description 详情: https://docs.microsoft.com/zh-cn/windows/win32/devnotes/rtlmovememory.
@param Destination 指向要复制字节的目标内存块的指针.
@param Source 指向要复制字节的源内存块的指针.
@param Length 从源复制到目标中的字节数.

func X创建保存对话框 ¶

func X创建保存对话框(选项结构指针 *OpenFileNameW) bool

GetSaveFileNameW 创建一个保存对话框，让用户指定要保存的文件的驱动器、目录和名称。

@Description 详情: https://docs.microsoft.com/zh-cn/windows/win32/api/commdlg/nf-commdlg-GetSaveFileNameW.
@param unnamedParam1 指向包含用于初始化对话框的信息的 wapi.OpenFileNameW 结构的指针。当函数返回时，此结构包含有关用户文件选择的信息。
@return bool

func X创建打开对话框 ¶

func X创建打开对话框(选项结构指针 *OpenFileNameW) bool

GetOpenFileNameW 创建一个打开对话框，让用户指定要打开的文件或文件集的驱动器、目录和名称。

@Description 详情: https://docs.microsoft.com/zh-cn/windows/win32/api/commdlg/nf-commdlg-getopenfilenamew.
@param unnamedParam1 指向包含用于初始化对话框的信息的 wapi.OpenFileNameW 结构的指针。当函数返回时，此结构包含有关用户文件选择的信息。
@return bool

func X创建颜色对话框 ¶

func X创建颜色对话框(选项结构指针 *ChooseColor) bool

ChooseColorW 创建一个颜色对话框，使用户能够选择一种颜色。

@Description 详情: https://docs.microsoft.com/zh-cn/previous-versions/windows/desktop/legacy/ms646912(v=vs.85).
@param lpcc 指向 wapi.ChooseColor 结构的指针，该结构包含用于初始化对话框的信息。当函数返回时，此结构包含有关用户颜色选择的信息。
@return bool

func X剪贴板内容格式判断 ¶

func X剪贴板内容格式判断(格式 CF_) bool

IsClipboardFormatAvailable 确定剪贴板是否包含指定格式的数据.

@Description 详见: https://docs.microsoft.com/zh-cn/windows/win32/api/winuser/nf-winuser-IsClipboardFormatAvailable.
@param uFormat 标准或注册的剪贴板格式, wapi.CF_ .
@return bool

func X剪贴板取指定格式内容 ¶

func X剪贴板取指定格式内容(格式 CF_) uintptr

GetClipboardData 从剪贴板中检索指定格式的数据。剪贴板必须先前已打开.

@Description 详见: https://docs.microsoft.com/zh-cn/windows/win32/api/winuser/nf-winuser-GetClipboardData.
@param uFormat 剪贴板格式, wapi.CF_ .
@return uintptr 如果函数成功，则返回值是指定格式的剪贴板对象的句柄. 如果函数失败，则返回值为NULL.

func X剪贴板设置数据 ¶

func X剪贴板设置数据(格式 CF_, 指定格式数据句柄 uintptr) uintptr

SetClipboardData 以指定的剪贴板格式将数据放在剪贴板上。该窗口必须是当前剪贴板所有者，并且应用程序必须调用 OpenClipboard 函数.

@Description 详见: https://docs.microsoft.com/zh-cn/windows/win32/api/winuser/nf-winuser-setclipboarddata.
@param uFormat 标准或注册的剪贴板格式, wapi.CF_ .
@param hMem 指定格式的数据的句柄。该参数可以为0，表示窗口根据请求提供指定剪贴板格式的数据（渲染格式）.
@return uintptr 如果函数成功，则返回值是数据的句柄. 如果函数失败，则返回值为NULL.

func X剪辑版关闭 ¶

func X剪辑版关闭() bool

CloseClipboard 关闭剪贴板.

@Description 当窗口完成检查或更改剪贴板时，通过调用 CloseClipboard 关闭剪贴板。这使其他窗口能够访问剪贴板.
详见: https://docs.microsoft.com/zh-cn/windows/win32/api/winuser/nf-winuser-CloseClipboard.
@return bool

func X剪辑版打开 ¶

func X剪辑版打开(关联窗口句柄 uintptr) bool

OpenClipboard 打开剪贴板进行检查并防止其他应用程序修改剪贴板内容.

@Description 如果另一个窗口打开了剪贴板，则 OpenClipboard 会失败.
应用程序应在每次成功调用 OpenClipboard 后调用 CloseClipboard 函数.
除非调用 EmptyClipboard 函数，否则由hWndNewOwner参数标识的窗口不会成为剪贴板所有者.
如果应用程序在 hwnd 设置为0的情况下调用 OpenClipboard, EmptyClipboard 会将剪贴板所有者设置为NULL；这会导致 SetClipboardData 失败.
详见: https://docs.microsoft.com/zh-cn/windows/win32/api/winuser/nf-winuser-OpenClipboard.
@param hWnd 要与打开的剪贴板关联的窗口句柄。如果此参数为0，则打开的剪贴板与当前任务相关联.
@return bool

func X剪辑版清空 ¶

func X剪辑版清空() bool

EmptyClipboard 清空剪贴板并释放剪贴板中数据的句柄。然后该函数将剪贴板的所有权分配给当前打开剪贴板的窗口。

@Description 在调用 EmptyClipboard 之前，应用程序必须使用 OpenClipboard 函数打开剪贴板。
如果应用程序在打开剪贴板时指定了NULL窗口句柄，则 EmptyClipboard 会成功，但会将剪贴板所有者设置为NULL。请注意，这会导致 SetClipboardData 失败。
详见: https://docs.microsoft.com/zh-cn/windows/win32/api/winuser/nf-winuser-EmptyClipboard.
@return bool

func X加载图像W ¶

func X加载图像W(模块句柄 uintptr, 名称 string, 类型 IMAGE_, 宽度, cy int32, fuLoad LR_) uintptr

LoadImageW 加载图标、光标、动画光标或位图.

详见: https://learn.microsoft.com/zh-cn/windows/win32/api/winuser/nf-winuser-loadimagew.
@param hInst 包含要加载的图像的 DLL 或可执行文件 (.exe) 模块的句柄。 有关详细信息，请参阅 GetModuleHandle。若要 (图标、光标或位图文件) 加载预定义图像或独立资源，请将此参数设置为0.
@param name 要加载的图像。如果 hInst 参数为非0且 fuLoad 参数省略 LR_LOADFROMFILE， 则 name 指定 hInst 模块中的图像资源。如果要按名称从模块加载图像资源， 则 name 参数是指向包含映像资源名称的字符串。
@param Type 要加载的图像的类型。 wapi.IMAGE_ .
@param cx 图标或光标的宽度（以像素为单位）。 如果此参数为零且 fuLoad 参数 为LR_DEFAULTSIZE，则函数使用 SM_CXICON 或 SM_CXCURSOR 系统指标值来设置宽度。 如果此参数为零且未使用 LR_DEFAULTSIZE ，则函数使用实际资源宽度。
@param cy 图标或光标的高度（以像素为单位）。 如果此参数为零且 fuLoad 参数 为LR_DEFAULTSIZE，则函数使用 SM_CYICON 或 SM_CYCURSOR 系统指标值来设置高度。 如果此参数为零且未使用 LR_DEFAULTSIZE ，则函数使用实际资源高度。
@param fuLoad 此参数可使用以下一个或多个值: wapi.LR_ .
@return 返回HICON。

func X取最后一个错误 ¶

func X取最后一个错误() int32

GetLastError 检索调用线程的最后一个错误代码值。最后一个错误代码是在每个线程的基础上维护的。多个线程不会覆盖彼此的最后一个错误代码。

@Description 详情: https://docs.microsoft.com/zh-cn/windows/win32/api/winbase/nf-winbase-GetLastError.
@return 返回值是调用线程的最后一个错误代码。

func X图标创建并按资源 ¶

func X图标创建并按资源(presbits uintptr, dwResSize uint32, fIcon bool, dwVer uint32) (uintptr, error)

CreateIconFromResource 从描述图标的资源位创建图标或光标。若要指定所需的高度或宽度，请使用 CreateIconFromResourceEx 函数。

@Description 使用完图标后，请使用 DestroyIcon 函数销毁它。

详见: https://learn.microsoft.com/zh-cn/windows/win32/api/winuser/nf-winuser-createiconfromresource.

@param presbits 包含图标或游标资源位的 DWORD 对齐缓冲区指针。通常通过调用 LookupIconIdFromDirectory、 LookupIconIdFromDirectoryEx 和 LoadResource 函数来加载这些位。
@param dwResSize 参数指向的位集的大小（以字节为单位）。
@param fIcon 指示是要创建图标还是游标。 如果此参数为 TRUE，则创建图标。 如果为 FALSE，则创建游标。LOCALHEADER 结构定义游标热点，是从游标资源位读取的第一个数据。
@param dwVer presbits 参数指向的资源位的图标或光标格式的版本号。 该值必须大于或等于 0x00020000 且小于或等于 0x00030000。 此参数通常设置为 0x00030000。
@return HICON

func X图标销毁 ¶

func X图标销毁(图标句柄 uintptr) bool

DestroyIcon 销毁图标并释放图标占用的任何内存。

@Description 只需为使用以下函数创建的图标和游标调用 DestroyIcon ： CreateIconFromResourceEx (如果调用时没有 LR_SHARED 标志) 、 CreateIconIndirect 和 CopyIcon。 请勿使用此函数销毁共享图标。 只要从中加载共享图标的模块保留在内存中，共享图标就有效。
详见: https://learn.microsoft.com/zh-cn/windows/win32/api/winuser/nf-winuser-destroyicon.
@param hIcon 要销毁的图标的句柄。 图标不得处于使用中。

func X复制到缓冲区 ¶

func X复制到缓冲区(文本指针1, 文本指针2 uintptr) uintptr

LstrcpyW 将字符串复制到缓冲区.

@Description 详情: https://docs.microsoft.com/zh-cn/windows/win32/api/winbase/nf-winbase-LstrcpyW.
@param lpString1 用于接收 lpString2 参数指向的字符串内容的缓冲区. 缓冲区必须足够大以包含字符串，包括终止空字符.
@param lpString2 要复制的以 null 结尾的字符串.
@return uintptr 如果函数成功，则返回值是指向缓冲区的指针. 如果函数失败，则返回值为NULL, 并且lpString1可能不是以 null 结尾的.

func X对指定文件执行操作 ¶

func X对指定文件执行操作(父窗口句柄 uintptr, 操作类型, 文件名, 参数, 默认完整路径 string, 显示Cmd 炫彩常量类.SW_) int

ShellExecuteW 对指定文件执行操作.

@Description 详见: https://docs.microsoft.com/en-us/windows/win32/api/shellapi/nf-shellapi-shellexecutew.
@param hwnd 用于显示 UI 或错误消息的父窗口的句柄。如果操作与窗口无关，则此值可以为0.
@param lpOperation 填“open”则打开lpFlie文档.
@param lpFile 想用关联的程序打印或打开的一个程序名或文件名.
@param lpParameters 如果lpFile是一个可执行文件，则这个字串包含了传递给执行程序的参数.
@param lpDirectory 想使用的默认路径完整路径.
@param nShowCmd 定义了如何显示启动程序的常数值, xcc.SW_.
@return int 如果函数成功，则返回大于32的值。如果函数失败，则返回指示失败原因的错误值.

func X对话框打开文件夹 ¶

func X对话框打开文件夹(对话框选项 *BrowseInfoW) uintptr

SHBrowseForFolderW 显示一个对话框，使用户能够选择文件夹。

@Description 详见: https://docs.microsoft.com/zh-cn/windows/win32/api/shlobj_core/nf-shlobj_core-shbrowseforfolderw.
@param browseInfo 指向 wapi.BrowseInfoW 结构的指针，该结构包含用于显示对话框的信息。
@return uintptr 返回一个 PIDL，它指定所选文件夹相对于命名空间根的位置。如果用户在对话框中选择取消按钮，则返回值为NULL。返回的 PIDL 可能是文件夹快捷方式而不是文件夹。

func X延时 ¶

func X延时(毫秒 uint32)

Sleep 暂停当前线程的执行，直到超时间隔结束。若要进入可警报等待状态，请使用 SleepEx 函数。

详情: https://learn.microsoft.com/zh-cn/windows/win32/api/synchapi/nf-synchapi-sleep.

@param ms 毫秒.

func X延时EX ¶

func X延时EX(毫秒 uint32, bAlertable bool) uint32

SleepEx 挂起当前线程，直到满足指定的条件。 发生以下情况之一时，将继续执行：

- 调用 I/O 完成回调函数。 - 异步过程调用 (APC) 排队到线程。 - 超时间隔已过。

详情: https://learn.microsoft.com/zh-cn/windows/win32/api/synchapi/nf-synchapi-sleepex.

@param dwMilliseconds 暂停执行的时间间隔（以毫秒为单位）。
@param bAlertable 如果此参数为 FALSE，则函数在超时期限过后才会返回。 如果发生 I/O 完成回调，该函数不会立即返回，并且不会执行 I/O 完成函数。 如果 APC 已排队到线程，该函数不会立即返回，并且不会执行 APC 函数。如果 参数为 TRUE，并且调用此函数的线程与调用扩展 I/O 函数 (ReadFileEx 或 WriteFileEx) 的线程相同，则当超时期限已过或发生 I/O 完成回调函数时，函数将返回 。 如果发生 I/O 完成回调，则调用 I/O 完成函数。 如果将 APC 排队到 queueUserAPC) (线程，则当超时期限已过或调用 APC 函数时，函数将返回 。
@return 如果指定的时间间隔过期，则返回值为零。如果函数由于一个或多个 I/O 完成回调函数而返回，则返回值WAIT_IO_COMPLETION。 仅当 bAlertable 为 TRUE，并且调用 SleepEx 函数的线程与调用扩展 I/O 函数的线程相同时，才会发生这种情况。

func X拖放文件取路径 ¶

func X拖放文件取路径(hDrop uintptr, iFile uint32, lpszFile *string, cch uint32) int

DragQueryFileW 检索由成功的拖放操作产生的文件路径.

@Description 详见: https://docs.microsoft.com/en-us/windows/win32/api/shellapi/nf-shellapi-DragQueryFileW.
@param hDrop 句柄.
@param iFile 文件索引.
@param lpszFile 返回的文件路径.
@param cch 接收的文件路径的字符数, 通常为260.
@return int 返回文件路径的字符数.

func X拖放文件取鼠标位置 ¶

func X拖放文件取鼠标位置(句柄 uintptr, 接收鼠标指针的坐标 *炫彩基类.POINT) bool

DragQueryPoint 检索在拖放文件时鼠标指针的位置.

@Description 详见: https://docs.microsoft.com/en-us/windows/win32/api/shellapi/nf-shellapi-DragQueryPoint.
@param hDrop 句柄.
@param ppt 接收鼠标指针的坐标.
@return bool 如果拖放发生在窗口的客户区, 返回true；否则返回false.

func X文件夹指针取实际路径 ¶

func X文件夹指针取实际路径(文件夹指针 uintptr, 返回文件路径 *string) bool

SHGetPathFromIDListW 将 SHBrowseForFolderW 的返回值转换为文件路径。

@Description 详见: https://docs.microsoft.com/zh-cn/windows/win32/api/shlobj_core/nf-shlobj_core-shgetpathfromidlistw.
@param pidl SHBrowseForFolderW 的返回值.
@param pszPath 返回的文件路径。
@return bool

func X检索指定模块句柄 ¶

func X检索指定模块句柄(已加载模块名称 string) uintptr

GetModuleHandleW 检索指定模块的模块句柄。 模块必须已由调用进程加载。

详情: https://learn.microsoft.com/zh-cn/windows/win32/api/libloaderapi/nf-libloaderapi-getmodulehandlew.

@param lpModuleName 加载的模块的名称 (.dll 或 .exe 文件) 。 如果省略文件扩展名，则会追加默认库扩展名 .dll。 文件名字符串可以包含尾随点字符 (.) ，以指示模块名称没有扩展名。 字符串不必指定路径。 指定路径时，请务必使用反斜杠 (\) ，而不是使用 /) (正斜杠。 名称 (大小写独立比较，) 当前映射到调用进程的地址空间的模块的名称。如果此参数为空， 则 GetModuleHandleW 返回用于创建调用进程 (.exe 文件) 的文件的句柄。
@return uintptr

func X窗口发送消息 ¶

func X窗口发送消息(窗口句柄 uintptr, 消息值 int32, 参数1, 参数2 uint) int

SendMessageW 将指定的消息发送到一个或多个窗口。SendMessage函数调用指定窗口的窗口过程，直到窗口过程处理完消息才返回。

@Description 详见: https://docs.microsoft.com/zh-cn/windows/win32/api/winuser/nf-winuser-SendMessageW.
@param hWnd 窗口句柄，其窗口过程将接收消息。如果该参数为 HWND_BROADCAST ((HWND)0xffff)，则将消息发送到系统中的所有顶层窗口，包括禁用或不可见的无主窗口、重叠窗口和弹出窗口；但消息不会发送到子窗口。
@param Msg 要发送的消息。有关系统提供的消息的列表，请参阅: https://docs.microsoft.com/en-us/windows/win32/winmsg/about-messages-and-message-queues.
@param wParam 其他特定于消息的信息。
@param lParam 其他特定于消息的信息。
@return int 返回值指定消息处理的结果；这取决于发送的消息。

func X窗口取屏幕坐标 ¶

func X窗口取屏幕坐标(窗口句柄 uintptr, 坐标指针 *POINT) bool

ClientToScreen 将指定点的客户区坐标转换为屏幕坐标。

@Description 详见: https://docs.microsoft.com/zh-cn/windows/win32/api/winuser/nf-winuser-ClientToScreen.
@param hWnd 窗口真实句柄
@param lpPoint wapi.POINT 指针. 如果函数成功，则将新的屏幕坐标复制到此结构中.
@return bool

func X窗口取标题 ¶

func X窗口取标题(窗口或控件句柄 uintptr, 接收文本 *string, 最大字符数 int) int

GetWindowTextW 将指定窗口标题栏（如果有）的文本复制到缓冲区中。如果指定的窗口是控件，则复制控件的文本。但是无法检索另一个应用程序中控件的文本。

@Description 详见: https://docs.microsoft.com/zh-cn/windows/win32/api/winuser/nf-winuser-GetWindowTextW.
@param hWnd 包含文本的窗口或控件的句柄。
@param lpString 接收文本.
@param nMaxCount 复制到缓冲区的最大字符数，包括空字符。如果文本超出此限制，则将其截断.
@return int 如果函数成功，则返回值是复制字符串的长度（以字符为单位），不包括终止空字符。如果窗口没有标题栏或文本，如果标题栏为空，或者窗口或控制句柄无效，则返回值为零。

func X窗口取标题长度 ¶

func X窗口取标题长度(窗口或控件句柄 uintptr) int

GetWindowTextLengthW 检索指定窗口标题栏文本的长度（以字符为单位）（如果窗口有标题栏）。如果指定的窗口是控件，则该函数检索控件内文本的长度。但是无法检索另一个应用程序中编辑控件的文本长度。

@Description 详见: https://docs.microsoft.com/zh-cn/windows/win32/api/winuser/nf-winuser-GetWindowTextLengthW.
@param hWnd 窗口或控件的句柄。
@return int 如果成功，则返回值是文本的长度（以字符为单位）。在某些情况下，此值可能大于文本的长度。如果窗口没有文本，则返回值为零。

func X窗口取桌面句柄 ¶

func X窗口取桌面句柄() uintptr

GetDesktopWindow 获取桌面窗口的句柄.

@Description 详见: https://docs.microsoft.com/zh-cn/windows/win32/api/winuser/nf-winuser-GetDesktopWindow.
@return int

func X窗口取顶级句柄 ¶

func X窗口取顶级句柄(窗口类名, 窗口标题 string) uintptr

FindWindowW 检索顶级窗口的句柄，该窗口的类名称和窗口名称与指定的字符串匹配。 此函数不搜索子窗口。 此函数不执行区分大小写的搜索.

@Description 如果 lpWindowName 参数不 为 NULL， FindWindowW 将调用 GetWindowTextW 函数以检索窗口名称进行比较。 有关可能出现的潜在问题的说明，请参阅 GetWindowTextW 的备注。
详见: https://learn.microsoft.com/zh-cn/windows/win32/api/winuser/nf-winuser-FindWindowW.
@param lpClassName 窗口类名, 可为空.
@param lpWindowName 窗口名称（窗口的标题）, 可为空.
@return 返回窗口句柄。

func X窗口句柄是否有效 ¶

func X窗口句柄是否有效(窗口的句柄 uintptr) bool

IsWindow 判断一个窗口句柄是否有效.

@Description 线程不应将 IsWindow 用于未创建的窗口，因为调用此函数后可能会销毁该窗口。 此外，由于窗口句柄被回收，句柄甚至可以指向其他窗口.
详见: https://learn.microsoft.com/zh-cn/windows/win32/api/winuser/nf-winuser-iswindow.
@param hWnd 要测试的窗口的句柄。
@return bool

func X窗口投递消息 ¶

func X窗口投递消息(窗口句柄 uintptr, 消息值 int32, 参数1, 参数2 uint) bool

PostMessageW 在与创建指定窗口的线程关联的消息队列中放置（发布）一条消息，并在不等待线程处理消息的情况下返回。

@Description 详见: https://docs.microsoft.com/zh-cn/windows/win32/api/winuser/nf-winuser-postmessagew.
@param hWnd 窗口句柄，其窗口过程将接收消息。如果该参数为 HWND_BROADCAST ((HWND)0xffff)，则将消息发送到系统中的所有顶层窗口，包括禁用或不可见的无主窗口、重叠窗口和弹出窗口；但消息不会发送到子窗口。
@param Msg 要发送的消息。有关系统提供的消息的列表，请参阅: https://docs.microsoft.com/en-us/windows/win32/winmsg/about-messages-and-message-queues.
@param wParam 其他特定于消息的信息。
@param lParam 其他特定于消息的信息。
@return bool

func X窗口模糊搜索子窗口 ¶

func X窗口模糊搜索子窗口(窗口句柄, 子窗口句柄 uintptr, 类名, 窗口标题 string) uintptr

FindWindowExW 检索类名称和窗口名称与指定字符串匹配的窗口的句柄. 该函数搜索子窗口，从指定子窗口后面的那个开始. 此函数不执行区分大小写的搜索.

@Description 详见: https://docs.microsoft.com/zh-cn/windows/win32/api/winuser/nf-winuser-FindWindowExW.
@param hWndParent 要搜索其子窗口的父窗口的句柄. 如果hwndParent为0，该函数使用桌面窗口作为父窗口. 该函数在作为桌面子窗口的窗口中进行搜索.
@param hWndChildAfter 子窗口的句柄。搜索从 Z 顺序中的下一个子窗口开始。子窗口必须是hwndParent的直接子窗口，而不仅仅是后代窗口。 如果hwndChildAfter为0，则搜索从hwndParent的第一个子窗口开始。 请注意，如果hwndParent和hwndChildAfter都是0，则该函数将搜索所有顶级和仅消息窗口。
@param lpszClass 窗口类名, 可空.
@param lpszWindow 窗口名称（窗口的标题）, 可空.
@return uintptr

func X窗口激活 ¶

func X窗口激活(窗口句柄 uintptr) bool

SetForegroundWindow 将创建指定窗口的线程带到前台并激活窗口. 键盘输入被定向到窗口, 并且为用户改变了各种视觉提示. 系统为创建前台窗口的线程分配比其他线程稍高的优先级.

@Description 详见: https://docs.microsoft.com/zh-cn/windows/win32/api/winuser/nf-winuser-SetForegroundWindow.
@param hWnd 应激活并置于前台的窗口句柄.
@return bool

func X窗口设置位置 ¶

func X窗口设置位置(窗口句柄 uintptr, 置顶方式 HWND_, 新x坐标, 新y坐标, 新宽度, 新高度 int32, 大小和定位标志 SWP_) bool

SetWindowPos 改变一个子窗口，弹出式窗口或顶层窗口的尺寸，位置和Z序。子窗口，弹出式窗口，及顶层窗口根据它们在屏幕上出现的顺序排序、顶层窗口设置的级别最高，并且被设置为Z序的第一个窗口.

@Description 详见: https://docs.microsoft.com/zh-cn/windows/win32/api/winuser/nf-winuser-SetWindowPos.
@param hWnd 欲定位的窗口句柄.
@param hWndInsertAfter 在Z序中位于定位窗口之前的窗口句柄. 此参数必须是窗口句柄或以下值之一: wapi.HWND_.
@param x 窗口新的x坐标。如hwnd是一个子窗口，则x用父窗口的客户区坐标表示.
@param y 窗口新的y坐标。如hwnd是一个子窗口，则y用父窗口的客户区坐标表示.
@param cx 指定新的窗口宽度.
@param cy 指定新的窗口高度.
@param wFlags 窗口大小和定位的标志. 该参数可以是以下值的组合: wapi.SWP_.
@return bool

func X结束 ¶

func X结束(结束代码 int32)

PostQuitMessage 向系统指示线程已请求终止（退出）。它通常用于响应 WM_DESTROY 消息。

@Description: https://docs.microsoft.com/zh-cn/windows/win32/api/winuser/nf-winuser-PostQuitMessage.
@param nExitCode 应用程序退出代码。该值用作 WM_QUIT 消息的wParam参数。

func X键盘热键注册 ¶

func X键盘热键注册(窗口句柄 uintptr, 热键标识符 int32, 组合键, 热键代码 uint32) bool

RegisterHotKey 注册系统范围的热键.

@Description 详见: https://docs.microsoft.com/zh-cn/windows/win32/api/winuser/nf-winuser-registerhotkey.
@param hWnd 真实窗口句柄。将接收由热键生成的 WM_HOTKEY 消息的窗口句柄。如果此参数为0，则 WM_HOTKEY 消息将发布到调用线程的消息队列中，并且必须在消息循环中进行处理。
@param id 热键的标识符。如果hWnd参数为0，则热键与当前线程相关联，而不是与特定窗口相关联。如果已存在具有相同hWnd和id参数的热键，请参阅备注了解所采取的操作。
@param fsModifiers 为了生成 WM_HOTKEY 消息，必须与vk参数指定的键组合按下的键 。fsModifiers参数可以是以下值的组合: xcc.Mod_ .
@param vk 热键的虚拟键代码: xcc.VK_ . 请参阅虚拟键码: https://docs.microsoft.com/zh-cn/windows/win32/inputdev/virtual-key-codes.
@return bool

func X键盘热键释放 ¶

func X键盘热键释放(窗口句柄 uintptr, 热键标识符 int32) bool

UnregisterHotKey 释放先前注册的热键.

@Description 详见: https://docs.microsoft.com/zh-cn/windows/win32/api/winuser/nf-winuser-unregisterHotKey.
@param hWnd 真实窗口句柄。与要释放的热键关联的窗口句柄。如果热键与窗口无关，则此参数应为0.
@param id 要释放的热键的标识符.
@return bool

func X鼠标取光标坐标 ¶

func X鼠标取光标坐标(坐标指针 *POINT) bool

GetCursorPos 检索鼠标光标的位置，以屏幕坐标表示.

@Description 详见: https://docs.microsoft.com/zh-cn/windows/win32/api/winuser/nf-winuser-getcursorpos.
@param lpPoint 指向接收光标屏幕坐标的 wapi.POINT 结构的指针.
@return bool