# SplashTextOn / SplashTextOff

创建或删除自定义文本的弹出窗口.

过时的: 不推荐在新脚本中使用这些命令. 请使用 Gui 命令代替.

    SplashTextOn , Width, Height, Title, Text
    SplashTextOff

## 参数

Width

  以像素为单位的窗口宽度. Default 200. 此参数可以为表达式.

Height

  窗口(不包括标题栏) 的高度, 单位为像素. 默认为 0(即只显示标题栏). 此参数可以为表达式.

标题

  窗口标题. 默认为空.

文本

  窗口的文本. 默认为空. 如果 Text 较长, 可以通过延续片段的方法将其分解成较短的几行, 这样可以增加可读性和可维护性.

## 备注

要对布局和字体名称/颜色/大小进行更多的控制, 请使用带 `zh0` 选项的 Progress 命令, 它不显示标题栏而只显示文本. 例如: `Progress, zh0 fs18, Some 18-point text to display`.

使用 SplashTextOff 命令来移除现有的弹出窗口.

弹出窗口是 "置顶的", 意味着它总是保持在其他所有普通窗口的上面. 要改变这种状态, 请使用 `WinSet, AlwaysOnTop, Off, <insert title of splash window>`. WinSet 还可以让弹出窗口透明.

WinMove 可以用来对此命令显示的 SplashText 窗口进行移动和调整大小.

与 Progress, SplashImage, MsgBox, InputBox, FileSelectFile 以及 FileSelectFolder 不同, 每个脚本只能显示一个 SplashText 窗口.

如果在已经显示弹出窗口时使用 SplashTextOn, 则使用新的参数值重新创建窗口. 然而, 当您想改变弹出窗口的标题或文本时与其重新创建弹出窗口, 不如使用下列方法来获得更好的性能, 尤其在需要频繁改变窗口时:

    WinSetTitle, <insert title of splash window>, , NewTitle
    ControlSetText, Static1, NewText, <insert title of splash window>

## 相关

Progress, SplashImage, ToolTip, MsgBox, InputBox, FileSelectFile, FileSelectFolder, WinMove, WinSet

## 示例

创建一个固定大小的弹出窗口, 显示剪贴板的内容, 并将其移动到屏幕的左上角.

    SplashTextOn, 400, 300, Clipboard, The clipboard contains:`n%Clipboard%
    WinMove, Clipboard,, 0, 0
    MsgBox, Press OK to dismiss the SplashText
    SplashTextOff

创建一个只显示标题栏的弹出窗口.

    SplashTextOn,,, Displays only a title bar.
    Sleep, 2000

dftg