用户输入
请用户输入内容。
当前模块定义
sys:userInput输入 17 · 输出 5 · 枚举 3
输入参数
- 类型
typeEnum必填输入内容的类型
4 个选项单行文本、多行文本、数字
单行文本默认text多行文本multiline数字number日期时间date_time - 提示文字
promptText必填提示用户输入什么内容。显示在输入框上方。
- 默认值
defaultValueText可选默认填写到输入框中的内容
- 文本选择工具
texttoolsText可选鼠标悬浮在文本框上时显示的小工具
- 扩展设置
extraSettingsText可选可用于自定义文本选择工具,详情请参考文档。
- 验证表达式
patternText可选正则验证表达式
- 必填
isRequiredBoolean可选是否必须填写内容
- 窗口位置
winLocationEnum可选在哪里显示选择窗口
11 个选项跟随鼠标(指针周围)、跟随鼠标(指针右下)、屏幕中间
跟随鼠标(指针周围)WithMouse1跟随鼠标(指针右下)WithMouse2屏幕中间默认CenterScreen屏幕左上TopLeft屏幕中上TopCenter屏幕右上TopRight屏幕左中LeftCenter屏幕右中RightCenter屏幕左下BottomLeft屏幕中下BottomCenter屏幕右下BottomRight - 恢复活动窗口
restoreFocusBoolean可选用户输入后,是否将焦点还原到之前的活动窗口
- 失去焦点后关闭窗口
closeOnDeactivatedBoolean可选 - 回车提交结果(Shift+回车换行)
submitWithReturnBoolean可选 - 字体名称
fontfamilyText可选可选。设置字体名称。如有2个字体,使用逗号分隔。
- 字体大小
fontsizeNumber必填 - 输入法状态
imeStateEnum可选不控制默认NO_CONTROL开启ON关闭OFF - 帮助按钮内容
helpText可选点击弹出显示帮助内容,MarkDown格式
- 置顶显示
topMostBoolean可选 - 失败后停止
stopIfFailBoolean可选用户取消后是否停止动作
输出参数
- 是否成功
isSuccessBoolean操作是否成功
- 文本值
textValueText文本类型的输入值
- 数字值
numberValueNumber数字类型的输入值
- 日期时间值
datetimeValueDateTime - 是否为空
isEmptyBoolean用户是否没有输入内容
概述
显示一个文本输入窗口,获取用户输入的内容。

注:
- 用户输入模块仅能用于输入一个信息,如果需要同时输入多个内容,以及使用其它类型的输入方式(如下拉选择等),请使用《多字段表单》模块。
参数
步骤参数示意(只读):
用户输入
输入参数
类型:输入内容的类型及输入方式。可选值:单行文本、多行文本、数字、日期时间。
提示文字:向用户显示的提示信息。
默认值:预先填写到输入框里的内容。
验证表达式:如果对输入的内容有格式要求,可以使用正则表达式进行验证。
必填:是否必须填写内容后才能保存。
恢复活动窗口:由于用户输入窗口会抢占输入焦点,如果希望在此窗口关闭后对原有软件窗口进行操作,可以选择此项以将输入焦点恢复到弹窗之前的窗口上。
失去焦点后关闭窗口:弹出输入窗口后,如果用户鼠标点击了窗口以外的地方,则自动关闭此窗口取消当前操作。
失败后停止:取消输入后,是否停止动作。
文本选择工具:在输入框右侧显示的工具按钮(鼠标悬浮在输入框上时显示),点击之后可以用于选择文件、进程路径等内容。
字体名称:输入框字体类型;
字体大小:输入框字体大小;
窗口位置:输入框的显示位置。
输入法状态:设置是否主动开启和关闭中文输入状态;
帮助按钮内容:Markdown格式的帮助内容,点击“帮助”按钮时显示。提示:
- 两个空格表示换行;
- [连接标题](网址)
- 支持一些[扩展的语法](<https://github.com/whistyun/MdXaml/wiki/How-to-use-Enhanched-syntax >)控制渲染格式。
输出
是否成功:是否成功获得了用户输入。
文本值:输入的文字内容(文本格式)。
数字值:输入的数字,用于输出到数字类型变量中。仅适用于类型为“数字”时。
是否为空:用户是否没有输入任何内容。
更新历史
- 1.1.0,增加“必填”选项。如果为非必填,允许空值的时候保存。
- 20241029 增加帮助按钮Markdown扩展语法文档链接。
示例动作
更新于