查看源代码 wx_misc (wx v2.4.3)
杂项函数。
概要
函数
将应用程序中所有窗口的鼠标光标更改为给定的光标。
响铃系统提示音。
以像素为单位返回显示尺寸。
将应用程序中所有窗口的鼠标光标恢复为原始光标。
查找与给定框架菜单栏关联的菜单项标识符。
在屏幕坐标中查找给定鼠标位置最深处的窗口，如果找到则返回该窗口，否则返回 NULL。
返回当前 ID。
通过连接 wxGetFullHostName() （在 wx 中未实现）和 wx_misc:getUserId/0 返回的值，将用户的电子邮件地址复制到提供的缓冲区中。
返回（当前）用户的 Home 目录。
对于普通按键，如果指定的按键当前被按下，则返回 true。
以屏幕坐标返回鼠标位置。
返回鼠标的当前状态。
返回包含当前平台描述的字符串，以用户可读的形式显示。
此函数返回“用户 ID”，在 Unix 下也称为“登录名”（例如。
如果两次 wx_misc:beginBusyCursor/1 和 wx_misc:endBusyCursor/0 调用之间，则返回 true。
如果程序运行的操作系统是 64 位，则返回 true。
如果当前平台是小端序（而不是大端序），则返回 true。
在用户的默认浏览器中打开 url。
已弃用
确保随后由 wx_misc:newId/0 生成的 ID 不会与给定的 id 冲突。
全局设置光标；仅在 Windows、Mac 和 GTK+ 上有效。
不要合成按住按键并生成具有自动重复功能的 KeyDown 事件的 KeyUp 事件。
在交互式 shell 窗口中执行命令。
等效于 shutdown([])。
此函数根据 flags 的值关闭或重启计算机。
函数
-spec beginBusyCursor() -> ok.
等效于 beginBusyCursor([])。
-spec beginBusyCursor([Option]) -> ok when Option :: {cursor, wxCursor:wxCursor()}.
将应用程序中所有窗口的鼠标光标更改为给定的光标。
使用 wx_misc:endBusyCursor/0 将光标恢复到之前的状态。这两个调用可以嵌套，并且计数器确保只有外部调用生效。
-spec bell() -> ok.
响铃系统提示音。
注意：此函数被归类为 GUI 函数，因此不是线程安全的。
以像素为单位返回显示尺寸。
注意：不建议在新代码中使用此函数，因为它仅适用于主显示器。请改用 wxDisplay:getGeometry/1 来检索适当显示器的尺寸。
如果调用者对相应的值不感兴趣，则输出指针中的任何一个都可以为 NULL。
参见：wxDisplay
-spec endBusyCursor() -> ok.
将应用程序中所有窗口的鼠标光标恢复为原始光标。
与 wx_misc:beginBusyCursor/1 一起使用。
-spec findMenuItemId(Frame, MenuString, ItemString) -> integer() when Frame :: wxFrame:wxFrame(), MenuString :: unicode:chardata(), ItemString :: unicode:chardata().
查找与给定框架菜单栏关联的菜单项标识符。
-spec findWindowAtPoint(Pt) -> wxWindow:wxWindow() when Pt :: {X :: integer(), Y :: integer()}.
在屏幕坐标中查找给定鼠标位置最深处的窗口，如果找到则返回该窗口，否则返回 NULL。
此函数会考虑给定位置的子窗口，即使它们已禁用。但是，它会跳过隐藏的子窗口。
-spec getCurrentId() -> integer().
返回当前 ID。
-spec getEmailAddress() -> unicode:charlist().
通过连接 wxGetFullHostName() （在 wx 中未实现）和 wx_misc:getUserId/0 返回的值，将用户的电子邮件地址复制到提供的缓冲区中。
返回：成功则为 true，否则为 false。
-spec getHomeDir() -> unicode:charlist().
返回（当前）用户的 Home 目录。
-spec getKeyState(Key) -> boolean() when Key :: wx:wx_enum().
对于普通按键，如果指定的按键当前被按下，则返回 true。
对于可切换的按键（大写锁定、数字锁定和滚动锁定），如果按键已切换，使其 LED 指示灯亮起，则返回 true。目前没有办法测试可切换的按键是按下还是弹起。
即使为鼠标按钮定义了虚拟键码，目前也不能与此函数一起使用。
在 wxGTK 中，目前不使用 X11 后端时，此函数只能与修饰键（WXK_ALT、WXK_CONTROL 和 WXK_SHIFT）一起使用。
以屏幕坐标返回鼠标位置。
-spec getMouseState() -> wx:wx_wxMouseState().
返回鼠标的当前状态。
返回一个 wx_wxMouseState() 实例，其中包含鼠标指针在屏幕坐标中的当前位置，以及指示鼠标按钮和修饰键的按下/弹起状态的布尔值。
-spec getOsDescription() -> unicode:charlist().
返回包含当前平台描述的字符串，以用户可读的形式显示。
例如，此函数可能会返回类似“Windows 10 (build 10240), 64-bit edition”或“Linux 4.1.4 i386”之类的字符串。
-spec getUserId() -> unicode:charlist().
此函数返回“用户 ID”，在 Unix 下也称为“登录名”（例如。
类似“jsmith”之类的字符串）。它唯一标识当前用户（在此系统上）。在 Windows 或 NT 下，此函数首先在环境变量 USER 和 LOGNAME 中查找；如果找不到，则会尝试 WIN.INI 文件的 wxWidgets 部分中的条目 UserId。
返回：如果成功，则返回登录名，否则返回空字符串。
-spec isBusy() -> boolean().
如果两次 wx_misc:beginBusyCursor/1 和 wx_misc:endBusyCursor/0 调用之间，则返回 true。
-spec isPlatform64Bit() -> boolean().
如果程序运行的操作系统是 64 位，则返回 true。
该检查在运行时执行，可能与编译时可用的值不同（在编译时，您可以检查 sizeof(void*) == 8），因为程序可能在模拟模式或混合 32/64 位系统（双架构操作系统）中运行。
注意：考虑到并非总是有一种标准方法可以对操作系统架构进行可靠检查，因此此函数在某些系统上并非 100% 可靠。
-spec isPlatformLittleEndian() -> boolean().
如果当前平台是小端序（而不是大端序），则返回 true。
该检查在运行时执行。
-spec launchDefaultBrowser(Url) -> boolean() when Url :: unicode:chardata().
-spec launchDefaultBrowser(Url, [Option]) -> boolean() when Url :: unicode:chardata(), Option :: {flags, integer()}.
在用户的默认浏览器中打开 url。
如果 flags 参数包含 wxBROWSER_NEW_WINDOW 标志，则会为 URL 打开一个新窗口（目前仅在 Windows 下支持）。
除非 flags 参数包含 wxBROWSER_NOBUSYCURSOR 标志，否则在浏览器启动时会显示忙碌光标（使用 wxBusyCursor（在 wx 中未实现））。
参数 url 的解释如下
如果它具有有效的方案（例如，
"file:"、"http:"或"mailto:"），则会将其传递给用户系统中配置的相应浏览器。如果它没有有效的方案（例如，它是没有
"file:"前缀的本地文件路径），则会使用 ?wxFileExists 和 ?wxDirExists 来测试它是否为本地文件/目录；如果是，则调用浏览器，其中url参数最终以"file:"为前缀。如果它没有有效的方案，也不是本地文件/目录，则会添加
"http:"前缀并调用浏览器。
如果应用程序成功启动，则返回 true。
注意：对于运行用户的某些配置，用于打开给定 URL 的应用程序可能依赖于 URL（例如，浏览器可能用于本地 URL，而另一个浏览器可能用于远程 URL）。
-spec mSWSetEmulationLevel(Level) -> boolean() when Level :: wx:wx_enum().
-spec mSWSetEmulationLevel(Level, Executable) -> boolean() when Level :: wx:wx_enum(), Executable :: string().
-spec newId() -> integer().
已弃用
它生成的 ID 可能与用户代码定义的 ID 冲突，请使用 wxID_ANY 来分配保证不与您创建的控件和菜单项的用户定义 ID 冲突的 ID，而不是使用此函数。
生成一个在此程序运行中唯一的整数标识符。
-spec registerId(Id) -> ok when Id :: integer().
确保随后由 wx_misc:newId/0 生成的 ID 不会与给定的 id 冲突。
-spec setCursor(Cursor) -> ok when Cursor :: wxCursor:wxCursor().
全局设置光标；仅在 Windows、Mac 和 GTK+ 上有效。
您应该使用 wxNullCursor 调用此函数以恢复系统光标。
请参见
不要合成按住按键并生成具有自动重复功能的 KeyDown 事件的 KeyUp 事件。
默认开启，并且在 wxMSW 中始终开启。
-spec shell() -> boolean().
等效于 shell([])。
-spec shell([Option]) -> boolean() when Option :: {command, unicode:chardata()}.
在交互式 shell 窗口中执行命令。
如果未指定命令，则只会生成 shell。
参见：示例
-spec shutdown() -> boolean().
等效于 shutdown([])。
此函数根据 flags 的值关闭或重启计算机。
注意：请注意，执行关闭需要相应的访问权限（Unix 下的超级用户，Windows 下的 SE_SHUTDOWN 权限），并且此函数仅在 Unix 和 MSW 下实现。
返回：成功则返回 true，如果发生错误则返回 false。