这是可以使用我们的多个免费在线工作站之一在 OnWorks 免费托管服务提供商中运行的命令对话框，例如 Ubuntu Online、Fedora Online、Windows 在线模拟器或 MAC OS 在线模拟器
程序：
您的姓名
dialog - 显示来自 shell 脚本的对话框
概要
对话框 - 清除
对话框 --创建-rc 文件
对话框 --打印-最大尺寸
对话框 共同选择 框选项
商品描述
对话 是一个程序，可以让您提出各种问题或显示消息
使用来自 shell 脚本的对话框。 实现了这些类型的对话框
（虽然不是所有的都必须编译成 对话框):
建造清单, 日历, 检查表, d选择, 编辑框, 申请, 选择, 测量, 信息框,
输入框, 输入菜单, 菜单, 混合形式, 混合规格, 消息框 （信息）， passwordbox,
密码表, 暂停, 程序盒, 程序箱, 进度条, 电台列表, 范围框, 尾箱,
尾箱, 文本框, 时间盒, 树形及 YESNO （是/否）。
您可以将多个对话框放入一个脚本中：
· 使用 ”--和小部件" 令牌强制 对话框 继续下一个对话框，除非你
已按 ESC 取消，或
· 简单地为下一个对话框添加令牌，形成一个链。 对话框停止链接
当对话框的返回码非零时，例如取消或否（请参阅诊断）。
一些小部件，例如清单，会将文本写入 对话框的输出。 通常那是
标准错误，但有更改此选项的选项：“--输出-fd“”--标准错误“而
"--标准输出". 如果按下取消按钮（或 ESC），则不会写入任何文本； 对话框 退出
在这种情况下立即。
配置
所有选项都以“--"（两个 ASCII 连字符，为了那些使用系统的人
带有混乱的语言环境支持）。
一个“--" 本身用作转义符，即命令行上的下一个标记不是
视为一种选择。
对话框 - 标题 -- - 不是 an 选项
该“--参数" 选项告诉 对话框 列出标准的命令行参数
错误。 这在使用“--“和”- 文件“， 自从
当这些被扩展时，命令行可能会被重写。
该“- 文件" 选项告诉 对话框 从命名为它的值的文件中读取参数。
对话框 - 文件 参数文件
不在双引号内的空格将被丢弃（使用反斜杠引用单引号
人物）。 结果插入命令行，替换“- 文件“和它的
选项值。 命令行的解释从那一刻开始。 如果
参数文件 开始于 ”＆”， 对话框 将以下文本解释为文件描述符
数字而不是文件名。
相当常见 附加选项
大多数常用选项在处理每个小部件之前都会重置。
--ascii 线
不要在框周围绘制图形线，而是在同一个地方绘制 ASCII“+”和“-”
地方。 也可以看看 ”--无线".
- 方面 比
这使您可以在使用自动调整大小时对框尺寸进行一些控制
（指定 0 表示高度和宽度）。 它代表宽度/高度。 默认是
9，这意味着每 9 行高 1 个字符。
--后台标题 后记
指定一个 后记 要显示在背景上的字符串，在
屏幕上。
- 开始 y x
指定对话框左上角在屏幕上的位置。
--取消标签 绳子
覆盖用于“取消”按钮的标签。
- 清除
清除小部件屏幕，仅保留 screen_color 背景。 使用这个时
您将小部件与“--和小部件" 擦除前一个小部件的内容
在屏幕上，因此不会在以下小部件的内容下看到。
将此理解为“的补充”--保持窗口"。要比较效果，请使用
这些：
所有三个小部件都可见，楼梯效果，顺序为 1,2,3、XNUMX、XNUMX：
对话框\
--begin 2 2 --yesno "" 0 0 \
--and-widget --begin 4 4 --yesno "" 0 0 \
--and-widget --begin 6 6 --yesno "" 0 0
只有最后一个小部件可见：
对话框\
--clear --begin 2 2 --yesno "" 0 0 \
--and-widget --clear --begin 4 4 --yesno "" 0 0 \
--and-widget --begin 6 6 --yesno "" 0 0
所有三个小部件都可见，楼梯效果，顺序为 3,2,1、XNUMX、XNUMX：
对话框\
--keep-window --begin 2 2 --yesno "" 0 0 \
--and-widget --keep-window --begin 4 4 --yesno "" 0 0 \
--and-widget --begin 6 6 --yesno "" 0 0
第一个和第三个小部件可见，楼梯效果，顺序 3,1：
对话框\
--keep-window --begin 2 2 --yesno "" 0 0 \
--and-widget --clear --begin 4 4 --yesno "" 0 0 \
--and-widget --begin 6 6 --yesno "" 0 0
请注意，如果您想恢复原始控制台颜色并将光标发送回家
对话程序退出后，使用 清除 (1) 命令。
- 颜色
通过以下字符解释对话文本中嵌入的“\Z”序列，
这告诉 对话框 设置颜色或视频属性：
· 0 到 7 是用于诅咒的 ANSI 颜色编号：黑色、红色、绿色、
分别为黄色、蓝色、品红色、青色和白色。
· 粗体由'b' 设置，由'B' 重置。
· 反向由'r'设置，由'R'复位。
· 下划线由'u'设置，由'U'重置。
· 设置是累积的，例如“\Zb\Z1”使下面的文字加粗
（也许是明亮的）红色。
· 用“\Zn”恢复正常设置。
--列分隔符 绳子
告诉 对话框 在出现的情况下拆分单选框/复选框和菜单的数据
给定的字符串，并将拆分的数据对齐到列中。
--cr-换行
将对话文本中嵌入的换行符解释为屏幕上的换行符。
除此以外， 对话框 只会在需要适合文本框的地方换行。
即使你可以控制换行符， 对话 仍然会换行
对于盒子的宽度来说太长了。 没有 cr-wrap，你的布局
文本可能会被格式化为在脚本的源代码中看起来不错，而无需
影响它在对话框中的外观。
另见“--没有崩溃“和”- 修剪”选项。
--创建-rc 文件
什么时候 对话框 支持运行时配置，这可用于转储样本
配置文件到指定的文件 文件.
- 日期格式 格式
如果房东提供 时间，此选项允许您指定
打印日期 - 日历 小部件。 一天中的时间（小时、分钟、秒）是
当前当地时间。
--默认否
将默认值设为 是/否 框 a 没有. 同样，制作默认按钮
提供“确定”和“取消”的小部件 取消. 如果 ”--no取消“或”- 访问-
项目" 给这些选项覆盖这个，使默认按钮始终
“是”（在内部与“OK”相同）。
--默认按钮 绳子
在小部件中设置默认（预选）按钮。 通过预先选择一个按钮，一个
脚本使用户可以简单地按 输入 通过一个
交互最少的对话。
选项的值是按钮的名称： ok, 含, 取消, 没有, 帮助 or 额外.
通常，每个小部件中的第一个按钮是默认按钮。 显示的第一个按钮是
由小部件和“- 角落“和”--no取消 选项。 如果
未给出此选项，未分配默认按钮。
--默认项 绳子
在清单、表单或菜单框中设置默认项。 通常是第一个项目
该框是默认值。
--退出标签 绳子
覆盖用于“退出”按钮的标签。
--额外按钮
在“确定”和“取消”按钮之间显示一个额外的按钮。
--额外标签 绳子
覆盖用于“额外”按钮的标签。 注意：对于输入菜单小部件，这
默认为“重命名”。
- 帮帮我 将帮助消息打印到标准输出并退出。 帮助信息也是
如果没有给出选项，或者给出了无法识别的选项，则打印。
--帮助按钮
在“确定”和“取消”按钮之后显示帮助按钮，即在清单、单选列表中
和菜单框。
退出时，返回状态将指示已按下“帮助”按钮。 对话
还将在标记“HELP”之后向其输出写入一条消息：
· 如果 ”--项目帮助" 也给出，项目帮助文本将被写入。
· 否则，将写入项目的标签（第一个字段）。
您可以使用 --帮助标签 选项和/或设置 DIALOG_ITEM_HELP 环境
变量来修改这些消息和退出状态。
--帮助标签 绳子
覆盖用于“帮助”按钮的标签。
--帮助状态
如果选择了帮助按钮，则写入清单、单选单或表格信息
在项目帮助“帮助”信息之后。 这可用于重建状态
处理帮助请求后的清单。
--帮助标签
修改退出时写入的消息 --帮助按钮 让他们永远只是
物品的标签。 这不会影响退出状态代码。
--h文件 文件名
当用户按下 F1 时，使用文本框显示给定的文件。
--h线 绳子
以小部件底部为中心显示给定的字符串。
- 忽略
忽略选项 对话框 不认识。 一些知名的如
"- 图标" 无论如何都会被忽略，但这是与兼容的更好选择
其他实现。
--输入-fd fd
从给定的文件描述符读取键盘输入。 最多 对话框 脚本读取自
标准输入，但仪表小部件读取管道（始终是标准的
输入）。 某些配置在以下情况下无法正常工作 对话框 试图重新打开
终端。 如果您使用此选项（适当处理文件描述符）
脚本必须在那种类型的环境中工作。
--不安全
通过为每个密码小部件回显星号，使密码小部件更友好但安全性更低
字符。
--iso 周
设置“周数”中显示的起始点- 日历“ 选项
根据 ISO-8601，从第一周开始编号，其中包括
一月的星期四。
--项目帮助
解释清单、单选列表和菜单框的标签数据添加一列
显示在屏幕的底部，对于当前选择的
项目。
--保持-tite
当用 诅咒, 对话框 通常会检查它是否正在运行
xterm的，并且在这种情况下尝试抑制初始化字符串
让它切换到备用屏幕。 在正常和备用之间切换
屏幕在运行的脚本中在视觉上分散注意力 对话框 几次。 用
这个选项允许 对话框 使用这些初始化字符串。
--保持窗口
通常当 对话框 执行几个 尾箱 由“连接的小部件”- 和-
小部件"，它通过在屏幕上绘画来清除屏幕上的旧小部件。使用这个
抑制重绘的选项。
在退出时， 对话框 重新绘制所有标有“的小部件”- 保持-
窗口”，即使他们不是 尾箱 小部件。 这导致它们被重新粉刷
以相反的顺序。 见讨论“- 清除"示例选项。
--最后一个键
在退出时，报告用户输入的最后一个键。 这是诅咒关键代码
而不是符号或文字字符。 它可以被脚本用来
区分绑定到同一动作的两个键。
--最大输入 尺寸
将输入字符串限制为给定的大小。 如果未指定，则限制为 2048。
--不可取消
--no取消
在清单、输入框和菜单框模式下禁止“取消”按钮。 一个脚本
仍然可以测试用户是否按下 ESC 键取消退出。
--没有崩溃
通常情况下 对话框 将制表符转换为空格并将多个空格减少为一个
显示在消息框等中的文本的空间。使用此选项可以
禁用该功能。 注意 对话框 仍将换行文本，受“--cr-
包装“和”- 修剪”选项。
- 没有相关产品
一些小部件（清单、输入菜单、收音机列表、菜单）显示一个包含两个的列表
列（“标签”和“项目”，即“描述”）。 这个选项告诉 对话框 至
读取较短的行，省略列表的“项目”部分。 这是偶尔
有用，例如，如果标签提供足够的信息。
参见 --无标签. 如果给出了两个选项，则忽略此选项。
--不杀
告诉 对话框 放 尾箱 背景中的框，将其进程 ID 打印到
对话框的输出。 后台进程禁用 SIGHUP。
- 无标签 绳子
覆盖用于“否”按钮的标签。
--无线
与其在盒子周围画线，不如在同一个地方画空间。 也可以看看
"--ascii 线".
--无鼠标
不要启用鼠标。
--no-nl-展开
不要将消息/提示文本的“\n”子字符串转换为文字换行符。
- 角落
- 角落 在清单、输入框和菜单框模式下禁止“确定”按钮。 一个脚本可以
仍然测试用户是否按下“Enter”键接受数据。
--无阴影
抑制将在每个对话框的右侧和底部绘制的阴影。
--无标签
一些小部件（清单、输入菜单、收音机列表、菜单）显示一个包含两个的列表
列（“标签”和“描述”）。 该标签对脚本很有用，但可能没有
帮助用户。 这 --无标签 选项（来自 Xdialog）可用于抑制
显示的标签列。 不像 - 没有相关产品 选项，这不
影响从脚本中读取的数据。
Xdialog 不显示类似的构建列表和树视图的标签列
小部件； 对话框 做同样的事情。
通常情况下 对话框 允许您快速移动到显示列表中的条目，通过
将单个字符与标签的第一个字符匹配。 当。。。的时候 --无标签
给出了选项， 对话框 匹配描述的第一个字符。 在
无论哪种情况，可匹配的字符都会突出显示。
--ok-标签 绳子
覆盖用于“确定”按钮的标签。
--输出-fd fd
直接输出到给定的文件描述符。 最多 对话框 脚本写入
标准错误，但错误消息也可能写在那里，这取决于您的
脚本。
- 分隔器 绳子
--输出分隔符绳子
指定一个字符串来分隔输出 对话框的清单输出，
而不是换行符（对于 --单独输出) 或空格。 这适用于其他
小部件，例如通常使用换行符的表单和编辑框。
--打印-最大尺寸
打印对话框的最大尺寸，即屏幕尺寸，以 对话框的输出。
这可以单独使用，没有其他选项。
--打印尺寸
将每个对话框的大小打印到 对话框的输出。
--打印版本
拷贝（Prints） 对话框的版本 对话框的输出。 这可以单独使用，没有其他
选项。 它不会导致 对话框 自行退出。
- 引
通常情况下 对话框 引用由清单返回的字符串以及项目帮助
文本。 使用此选项引用所有字符串结果。
--滚动条
对于包含可滚动数据集的小部件，请在其右边距绘制滚动条。
这对鼠标没有反应。
--单独输出
对于某些小部件（buildlist、checklist、treeview），输出结果一行
时间，没有引用。 这有利于另一个程序的解析。
--单独的小部件 绳子
指定一个字符串来分隔输出 对话框来自每个小部件的输出。
这用于简化解析具有多个小部件的对话框的结果。 如果
未给出此选项，默认分隔符字符串是制表符。
- 阴影
在每个对话框的右侧和底部绘制一个阴影。
--单引号
根据需要使用单引号（如果不需要，则不使用引号）作为输出
清单以及项目帮助文本。 如果未设置此选项， 对话框 使用
每个项目周围的双引号。 在任一情况下， 对话框 添加反斜杠使
在 shell 脚本中有用的输出。
--大小错误
在尝试使用之前检查对话框的结果大小，打印
如果它大于屏幕，则结果大小。 （此选项已过时，因为
检查所有新窗口调用）。
- 睡觉 秒
处理对话框后休眠（延迟）给定的秒数。
--标准错误
直接输出到标准错误。 这是默认设置，因为通常会诅咒
将屏幕更新写入标准输出。
--标准输出
直接输出到标准输出。 提供此选项是为了兼容性
使用 Xdialog，但是不推荐在可移植脚本中使用它，因为 Curses
通常将其屏幕更新写入标准输出。 如果您使用此选项，
对话框 尝试重新打开终端，以便它可以写入显示器。 依赖
在平台和您的环境中，这可能会失败。
--tab-正确
将每个制表符转换为一个或多个空格（对于 文本框 小部件； 除此以外
到一个空格）。 否则，选项卡将根据 Curses 库的
解释。
--tab 长度 n
指定制表符占用的空格数，如果“--tab-正确"
给出了选项。 默认为 8。此选项仅对 文本框
小部件。
- 时间格式 格式
如果房东提供 时间，此选项允许您指定
打印的时间 --时间框 小部件。 在这种情况下的日、月、年值
是当前当地时间。
- 暂停 秒
如果在给定的次数内没有用户响应，则超时（以错误代码退出）
秒。 忽略零秒超时。
“- 暂停" 小部件。如果
背景 ”--tailboxbg" 选项用于设置多个并发小部件。
- 标题 标题
指定一个 标题 显示在对话框顶部的字符串。
- 痕迹 文件名
将命令行参数、击键和其他信息记录到给定的
文件。 如果 对话框 读取配置文件，它也会被记录。 管道输入
测量 小部件已记录。 使用 control/T 记录当前对话框的图片
窗口。
--周开始 天
设置一周的开始日期，用于“- 日历" 选项。 天
参数可以是
· 一个数字（0 到 6，周日到周六使用 POSIX）或
· 特殊值“locale”（这适用于使用 glibc 的系统，提供一个
扩展到 当地 命令， 第一个工作日 值）。
· 一个字符串匹配显示在星期几的缩写之一
日历 小部件，例如“星期一”的“Mo”。
对话框 程序专门处理一些命令行参数，并将它们从
处理时的参数列表。 例如，如果第一个选项是 - 痕迹,
然后在之前处理（和删除） 对话框 初始化显示。
- 修剪 消除前导空格，修剪文字换行符和消息中的重复空格
文本。
另见“--cr-换行“和”--没有崩溃”选项。
- 版
拷贝（Prints） 对话框的版本到标准输出，然后退出。 也可以看看 ”- 打印-
版本".
--访问项目
修改 checklist、radiolist、menubox 和 inputmenu 的 tab 遍历以包含
作为状态之一的项目列表。 这可用作视觉辅助工具，即
光标位置对一些用户有帮助。
当给出这个选项时，光标最初被放置在列表上。
缩写（标签的第一个字母）适用于列表项。 如果您选择
按钮行，缩写适用于按钮。
--是标签 绳子
覆盖用于“是”按钮的标签。
盒子 附加选项
所有对话框至少有三个参数：
文本 框的标题或内容。
高度 对话框的高度。
宽度 对话框的宽度。
其他参数取决于盒子类型。
--构建列表 文本 高度 宽度 列表高度 [ 行李牌 项目 状态 ] ...
A 建造清单 对话框并排显示两个列表。 左边的列表显示
未选择的项目。 右侧的列表显示所选项目。 由于项目是
选中或未选中，它们在列表之间移动。
使用回车或“确定”按钮接受当前值
选择窗口并退出。 结果是使用显示在
选定的窗口。
每个条目的初始开/关状态由 状态.
该对话框的行为类似于 菜单， 使用 --访问项目 来控制是否
允许游标直接访问列表。
· 如果 --访问项目 未给出，选项卡遍历使用两种状态（确定/取消）。
· 如果 --访问项目 给定，制表符遍历使用四种状态
（左/右/确定/取消）。
不论是否 --访问项目 给定，可以在之间移动突出显示
这两个列表使用默认的“^”（左列）和“$”（右列）键。
在退出时，一个列表 行李牌 那些被打开的条目的字符串将是
印在 对话框的输出。
如果“--单独输出" 选项未给出，字符串将被引用为
需要使脚本很容易将它们分开。 默认情况下，这使用
双引号。 见“--单引号" 选项，它修改引用
行为。
- 日历 文本 高度 宽度 天 月 年
A 日历 框在可单独调节的窗口中显示月、日和年。 如果
日、月或年的值缺失或为负，当前日期的
使用相应的值。 您可以增加或减少任何使用
向左、向上、向右和向下箭头。 使用 vi 风格的 h、j、k 和 l 进行移动
围绕一个月中的天数数组。 使用 tab 或 backtab 在窗口之间移动。
如果年份为零，则将当前日期用作初始值。
退出时，日期以日/月/年的形式打印。 格式可以是
使用覆盖 - 日期格式 选项。
--清单 文本 高度 宽度 列表高度 [ 行李牌 项目 状态 ] ...
A 检查表 盒子类似于 菜单 盒子; 有多个条目出现在
菜单的形式。 另一个区别是您可以指明哪个条目是
当前选定的，通过设置其 状态 至 on. 而不是选择一个条目
在条目中，每个条目都可以由用户打开或关闭。 最初的
每个条目的开/关状态由 状态.
在退出时，一个列表 行李牌 那些被打开的条目的字符串将是
印在 对话框的输出。
如果“--单独输出" 选项未给出，字符串将被引用为
需要使脚本很容易将它们分开。 默认情况下，这使用
双引号。 见“--单引号" 选项，它修改引用
行为。
--d选择 文件路径 高度 宽度
目录选择对话框显示一个文本输入窗口，您可以在其中键入
目录，上面是一个带有目录名称的窗口。
这里 文件路径 可以是文件路径，在这种情况下目录窗口将显示
路径的内容和文本输入窗口将包含预选的
目录。
使用 Tab 键或箭头键在窗口之间移动。 在目录窗口中，
使用向上/向下箭头键滚动当前选择。 使用空格键
将当前选择复制到文本输入窗口中。
键入任何可打印的字符将焦点切换到文本输入窗口，输入
该字符以及将目录窗口滚动到最接近的匹配项。
使用回车或“确定”按钮接受文本中的当前值-
进入窗口和退出。
退出时，文本输入窗口的内容被写入 对话框的输出。
--编辑框 文件路径 高度 宽度
编辑框对话框显示文件的副本。 您可以使用
退格, 删除 和光标键来纠正打字错误。 它也认
翻页/翻页。 不像 --输入框，您必须选择“确定”或“取消”
按钮关闭对话框。 在框中按“Enter”键将拆分
对应的行。
退出时，编辑窗口的内容被写入 对话框的输出。
- 形式 文本 高度 宽度 高度 [ 标签 y x 项目 y x 弗伦 伊伦 ] ...
申请 对话框显示一个由标签和字段组成的表单，它们是
通过脚本中给定的坐标定位在可滚动窗口上。 场
长度 弗伦 和输入长度 伊伦 告诉该字段可以持续多长时间。 前者
定义为选定字段显示的长度，而后者定义
字段中输入的数据的允许长度。
· 如果 弗伦 为零，则相应字段不能更改。 和内容
字段决定显示长度。
· 如果 弗伦 为负数，对应字段不可更改，取反
价值 弗伦 用作显示长度。
· 如果 伊伦 为零，它被设置为 弗伦.
使用向上/向下箭头（或 control/N、control/P）在字段之间移动。 使用制表符
在窗口之间移动。
退出时，表单域的内容被写入 对话框的输出，每个字段
由换行符分隔。 用于填充不可编辑字段的文本 (弗伦 为零或
负）未写出。
--f选择 文件路径 高度 宽度
选择 （文件选择）对话框显示一个文本输入窗口，您可以在其中
键入一个文件名（或目录），然后在两个带有目录名和
文件名。
这里 文件路径 可以是文件路径，在这种情况下文件和目录窗口将
显示路径的内容，文本输入窗口将包含
预选的文件名。
使用 Tab 键或箭头键在窗口之间移动。 在目录或
文件名窗口，使用向上/向下箭头键滚动当前选择。 用
空格键将当前选择复制到文本输入窗口中。
键入任何可打印的字符将焦点切换到文本输入窗口，输入
该字符以及将目录和文件名窗口滚动到
最接近的匹配。
键入空间字符的力量 对话框 完成当前名称（最多
可能与多个条目匹配的点）。
使用回车或“确定”按钮接受文本中的当前值-
进入窗口和退出。
退出时，文本输入窗口的内容被写入 对话框的输出。
- 测量 文本 高度 宽度 [百分]
A 测量 框沿框底部显示一个仪表。 仪表指示
百分比。 从标准输入中读取新百分比，每行一个整数。
仪表会更新以反映每个新的百分比。 如果标准输入读取
字符串“XXX”，那么接下来的第一行作为整数百分比，
然后到另一个“XXX”的后续行用于新提示。 仪表
当在标准输入上达到 EOF 时退出。
百分 value 表示仪表中显示的初始百分比。 如果不
指定，它为零。
退出时，没有文本写入 对话框的输出。 小部件不接受任何输入，因此
退出状态始终正常。
--信息框 文本 高度 宽度
An info 盒子基本上是一个 的话 盒子。 然而，在这种情况下， 对话框 将退出
在向用户显示消息后立即。 屏幕未清除
，尤其是 对话框 退出，以便消息将保留在屏幕上，直到调用
shell 脚本稍后会清除它。 这在您想通知用户时很有用
一些操作正在进行中，可能需要一些时间才能完成。
退出时，没有文本写入 对话框的输出。 返回 OK 退出状态。
--输入框 文本 高度 宽度 [在里面]
An 输入 当您想提出需要用户回答的问题时，框很有用
输入一个字符串作为答案。 如果提供了 init，它将用于初始化
输入字符串。 输入字符串时， 退格, 删除 和光标键可以
用于纠正打字错误。 如果输入字符串长于可以容纳
对话框中，输入字段将滚动。
退出时，输入字符串将打印在 对话框的输出。
--输入菜单 文本 高度 宽度 菜单高度 [ 行李牌 项目 ] ...
An 输入菜单 盒子与普通的非常相似 菜单 盒子。 只有几个
它们之间的区别：
1. 条目不会自动居中，而是向左调整。
2.一个额外的按钮（称为 重命名) 暗示重命名当前项目时
被按下。
3. 可以通过按 重命名当前条目 重命名 按钮。 然后
对话框 将写下以下内容 对话框的输出。
重命名
- 菜单 文本 高度 宽度 菜单高度 [ 行李牌 项目 ] ...
顾名思义， 菜单 box 是一个对话框，可以用来呈现列表
以菜单的形式供用户选择。 选项显示在
给出的命令。 每个菜单项包含一个 行李牌 字符串和一个 项目 细绳。 这
行李牌 为条目命名以区别于菜单中的其他条目。
项目 是条目代表的选项的简短描述。 用户
可以通过按光标键在菜单项之间移动，
此 行李牌 作为热键或数字键 1 通过 9。 有 菜单高度
条目一次显示在菜单中，但如果出现菜单将滚动
比这更多的条目。
退出时 行李牌 所选菜单项的内容将打印在 对话框的输出。 如果
该“--帮助按钮" 选项，则打印相应的帮助文本，如果
用户选择帮助按钮。
--混合形式 文本 高度 宽度 高度 [ 标签 y x 项目 y x 弗伦 伊伦 输入法 ] ...
混合形式 对话框显示一个由标签和字段组成的表单，很像
- 形式 对话。 它的不同之处在于向每个字段的添加字段类型参数
描述。 类型中的每一位表示该字段的一个属性：
1 隐藏，例如，密码字段。
2 只读，例如，标签。
--混合规格 文本 高度 宽度 百分 [ tag1 项目1 ] ...
A 混合规格 框沿框底部显示一个仪表。 仪表指示
百分比。
它还显示了一个列表 行李牌 - 和 项目- 框顶部的值。 看
对话框(3) 为标签值。
文本 显示为列表和仪表之间的标题。 这 百分 折扣值
表示仪表中显示的初始百分比。
没有规定从标准输入读取数据，因为 - 测量 一样。
退出时，没有文本写入 对话框的输出。 小部件不接受任何输入，因此
退出状态始终正常。
--消息框 文本 高度 宽度
A 的话 盒子非常类似于一个 是/否 盒子。 之间的唯一区别
的话 盒子和一个 是/否 盒子是一个 的话 盒子只有一个 OK 按钮。
您可以使用此对话框来显示您喜欢的任何消息。 阅读完后
消息，用户可以按 ENTER 关键是这样 对话框 将退出并调用
shell 脚本可以继续它的运行。
如果消息对于空间来说太大， 对话框 可能允许你滚动它，
前提是底层的 curses 实现足够强大。 在这
在这种情况下，小部件的底部会显示一个百分比。
退出时，没有文本写入 对话框的输出。 仅提供“确定”按钮
用于输入，但可能会返回 ESC 退出状态。
- 暂停 文本 高度 宽度 秒
A 暂停 框沿框底部显示一个仪表。 仪表指示如何
距离暂停结束还有很多秒。 超时时暂停退出
到达或用户按下 OK 按钮（状态 OK）或用户按下
取消按钮或 Esc 键。
--密码框 文本 高度 宽度 [在里面]
A 密码 box 类似于输入框，除了用户输入的文本是
不显示。 这在提示输入密码或其他敏感信息时很有用
信息。 请注意，如果在“init”中传递任何内容，它将在
系统的进程表可以随便窥探。 此外，它非常令人困惑
用户向他们提供他们看不到的默认密码。 由于这些原因，
非常不鼓励使用“init”。 看 ”--不安全“如果你不在乎你的
密码。
退出时，输入字符串将打印在 对话框的输出。
--密码形式 文本 高度 宽度 高度 [ 标签 y x 项目 y x 弗伦 伊伦 ] ...
这与 - 形式 除了所有文本字段都被视为 密码
小部件而不是 输入框 小部件。
--程序框 文本 命令 高度 宽度
--程序框 命令 高度 宽度
A 程序盒 非常类似于 程序箱.
此对话框用于显示指定为命令的命令的输出
争论 程序盒.
命令完成后，用户可以按 ENTER 关键是这样 对话框 将
退出，调用 shell 脚本可以继续其操作。
如果给出三个参数，则显示标题下的文本，划定
从滚动文件的内容。 如果只给出两个参数，则此文本为
省略。
--程序箱 文本 高度 宽度
--程序箱 高度 宽度
A 程序箱 非常类似于 进度条. 之间的唯一区别
程序 盒子和一个 进展 盒子是一个 程序 框显示一个 OK 按钮（但
只有在命令完成后）。
此对话框用于显示命令的管道输出。 之后
命令完成后，用户可以按 ENTER 关键是这样 对话框 将退出并
调用 shell 脚本可以继续其操作。
如果给出三个参数，则显示标题下的文本，划定
从滚动文件的内容。 如果只给出两个参数，则此文本为
省略。
--进度框 文本 高度 宽度
--进度框 高度 宽度
A 进度条 类似于 尾箱，除了
a) 而不是显示文件的内容，
它显示命令的管道输出和
b) 到达文件末尾时退出
（没有“确定”按钮）。
如果给出三个参数，则显示标题下的文本，划定
从滚动文件的内容。 如果只给出两个参数，则此文本为
省略。
--广播员 文本 高度 宽度 列表高度 [ 行李牌 项目 状态 ] ...
A 电台列表 盒子类似于 菜单 盒子。 唯一的区别是你可以
指示当前选择了哪个条目，通过设置其 状态 至 on.
退出时，所选项目的标签被写入 对话框的输出。
--尾箱 文件 高度 宽度
在对话框中显示文件中的文本，如“tail -f”命令。 滚动
使用 vi 样式的“h”和“l”或箭头键向左/向右。 '0' 重置滚动。
退出时，没有文本写入 对话框的输出。 仅提供“确定”按钮
用于输入，但可能会返回 ESC 退出状态。
--范围框 文本 高度 宽度 最小值 最大值 默认值
允许用户从一系列值中进行选择，例如使用滑块。 对话框
将当前值显示为条形（如仪表对话框）。 标签或箭头键移动
按钮和值之间的光标。 当光标位于该值上时，您
可以通过以下方式编辑它：
左/右光标移动以选择要修改的数字
+/- 字符以将数字递增/递减一
0 9通过
将数字设置为给定值
在所有光标位置也可以识别某些键：
回家/结束
将值设置为其最大值或最小值
向上翻页/向下翻页
增加值，使滑块移动一列
--tailboxbg 文件 高度 宽度
将对话框中文件中的文本显示为后台任务，如“tail -f &”
命令。 使用 vi 样式的“h”和“l”或箭头键向左/向右滚动。 一个“0”
重置滚动。
如果有其他小部件（- 和-
小部件) 同时出现在屏幕上。 直到这些小部件关闭（例如，
“好的”）， 对话框 将在同一进程中执行所有 tailboxbg 小部件，
轮询更新。 您可以使用选项卡在
屏幕，然后单独关闭它们，例如，通过按 ENTER. 一旦非
tailboxbg 小部件已关闭， 对话框 将自身的副本分叉到后台，
如果“--不杀" 选项已给出。
退出时，没有文本写入 对话框的输出。 仅提供“退出”按钮
用于输入，但可能会返回 ESC 退出状态。
注意：旧版本的 对话框 立即分叉并尝试更新
单独屏幕。 除了对性能不利之外，它也是行不通的。 一些
较旧的脚本可能无法与轮询方案一起正常工作。
- 文本框 文件 高度 宽度
A 文本 box 允许您在对话框中显示文本文件的内容。 这是
就像一个简单的文本文件查看器。 用户可以通过使用
光标、向上翻页、向下翻页和 主页/结束 大多数键盘上可用的键。 如果
行太长而无法显示在框中， 左右 键可用于
水平滚动文本区域。 您还可以使用 vi 样式的键 h、j、k 和 l
代替光标键，用 B 或 N 代替向上翻页和向下翻页键。
使用 vi 样式的“k”和“j”或箭头键向上/向下滚动。 使用左右滚动
vi 样式的“h”和“l”，或箭头键。 “0”重置左/右滚动。 为了
更方便，vi风格的向前和向后搜索功能也有
提供。
退出时，没有文本写入 对话框的输出。 仅提供“退出”按钮
用于输入，但可能会返回 ESC 退出状态。
--时间框 文本 高度 [宽度 小时 分钟 第二]
将显示一个对话框，允许您选择小时、分钟和秒。 如果
小时、分钟或秒的值缺失或为负，当前日期的
使用相应的值。 您可以增加或减少任何使用
向左、向上、向右和向下箭头。 使用 tab 或 backtab 在之间移动
视窗。
退出时，结果以小时：分钟：秒的形式打印。 格式可以是
使用覆盖 - 时间格式 选项。
- 树视图 文本 高度 宽度 列表高度 [ 行李牌 项目 状态 深度 ] ...
显示组织为树的数据。 每组数据包含一个标签，文本到
显示项目、其状态（“开”或“关”）以及项目在
树。
只能选择一项（例如 电台列表）。 标签不显示。
退出时，所选项目的标签被写入 对话框的输出。
--是的 文本 高度 宽度
A 是/否 大小对话框 高度 行 宽度 将显示列。 这
由指定的字符串 文本 显示在对话框内。 如果这个字符串太
长到一行，会自动分成多行
适当的地方。 这 文本 字符串也可以包含子字符串“\n“ 要么
换行符`\n' 来明确控制换行。 这个对话框是
用于提出要求用户回答是或否的问题。 这
对话框有一个 USB MIDI（XNUMX通道） 按钮和一个 没有 按钮，用户可以在其中切换
按下 TAB 键。
退出时，没有文本写入 对话框的输出。 除了“是”和“否”
退出代码（请参阅诊断）可能会返回 ESC 退出状态。
用于“是”和“否”的代码与用于“确定”和“取消”的代码相匹配，
内部没有区别。
过时的 附加选项
- 嘟 这用于告诉原始 cdialog，它应该在
tailboxbg 小部件的单独进程将重新绘制屏幕。
--哔哔声
用户通过按下其中一个按钮完成小部件后发出蜂鸣声。
运行 配置
1. 通过键入以下内容创建示例配置文件：
对话框 --create-rc 文件
2. 开始时， 对话框 确定要使用的设置如下：
a) 如果环境变量 对话 被设置，它的值决定了名称
配置文件。
b) 如果没有找到 (a) 中的文件，则使用该文件 $HOME/.dialogrc 作为配置
文件中。
c) 如果未找到 (b) 中的文件，请尝试使用确定的 GLOBALRC 文件
编译时，即 /etc/dialogrc.
d) 如果未找到 (c) 中的文件，则使用默认编译。
3. 编辑示例配置文件并将其复制到某个地方 对话框 可以找到，如
在上面的步骤 2 中说明。
KEY 绑定
您可以覆盖或添加到键绑定 对话框 通过添加到配置文件。
对话's 绑定键 命令将单个键映射到其内部编码。
绑定键 小部件 诅咒密钥 对话键
小部件 名称可以是“*”（所有小部件），或特定小部件，例如 文本框。 具体
小部件绑定覆盖“*”绑定。 用户定义的绑定覆盖内置的
绑定。
诅咒密钥 可以是派生自的任何名称 诅咒.h，例如，“帮助”来自
“KEY_HELP”。 对话 还识别 ANSI 控制字符，例如“^A”、“^?”，以及
C1 控件，例如“~A”和“~?”。 最后，它允许对任何单个字符进行转义
带反斜杠。
对话的内部键码名称对应于 DLG_KEYS_ENUM 输入 dlg_keys.h，例如，
来自“DLGK_HELP”的“帮助”。
窗口小部件 名称
一些小部件（例如表单框）有一个可以编辑字段的区域。 那些是
在小部件的子窗口中管理，并且可能具有与主窗口不同的键绑定
小部件，因为子窗口使用不同的名称注册。
窗口小部件 窗口 姓名 子窗口 名字
────────────────────────────────────────────────
日历日历
清单清单
编辑框 editbox editbox2
表单表单框表单域
fselect fselect fselect2
输入框输入框输入框2
菜单菜单框菜单
消息框 消息框
暂停 暂停
进度框进度框
无线电通讯员
尾箱尾箱
文本框 文本框 搜索框
时间箱 时间箱
是的 是的 是的
────────────────────────────────────────────────
一些小部件实际上是其他小部件，使用内部设置来修改行为。
那些使用与实际小部件相同的小部件名称：
窗口小部件 实际 窗口小部件
────────────────────────────────
d选择 f选择
信息框
输入菜单
混合形式
密码框输入框
密码表格
prgbox 进度框
程序箱进度箱
尾箱bg尾箱
────────────────────────────────
内建的 绑定
本手册页没有列出每个小部件的键绑定，因为那详细
可以通过运行获取信息 对话框. 如果您设置了 - 痕迹 选项， 对话框
在注册时为每个小部件写入键绑定信息。
例如：
通常情况下 对话框 使用不同的键在按钮和编辑部分之间导航
对话框与在编辑部分中导航。 即tab（和back-tab）遍历
按钮（或按钮和编辑部分之间），而箭头键则遍历其中的字段
编辑部分。 制表符也被认为是在之间遍历的特殊情况
小部件，例如，当使用多个 tailboxbg 小部件时。
有些用户可能希望使用与编辑部分相同的键来遍历
在按钮之间穿梭。 编写表单小部件是为了支持这种
重新定义键，通过添加一个特殊的组 dlgk_keys.h 对于“形式”
（左/右/下一个/上一个）。 这是一个示例绑定，演示了如何执行此操作：
bindkey 表单域 TAB form_NEXT
bindkey 表单框 TAB form_NEXT
bindkey 表单域 BTAB form_prev
bindkey 表单框 BTAB form_prev
由于
可能需要遍历大量字段。
环境
对话框 定义此变量以将任何常见选项应用于每个小部件。
大多数常用选项在处理每个小部件之前都会重置。 如果你
在此环境变量中设置选项，它们将应用于 对话框's
复位后的状态。 正如在“- 文件" 选项、双引号和
反斜杠被解释。
该“- 文件" 选项不被视为通用选项（因此您不能嵌入
它在这个环境变量中）。
对话 如果要指定配置的名称，请定义此变量
要使用的文件。
对话取消
对话错误
DIALOG_ESC 对话
对话框_额外
对话帮助
DIALOG_ITEM_HELP
对话框_确定 定义这些变量中的任何一个以更改取消 (1) 上的退出代码，错误
(-1), ESC (255), 额外 (3), 帮助 (2), 帮助 --项目帮助 (2) 或确定 (0)。
通常 shell 脚本无法区分 -1 和 255。
对话_TTY 将此变量设置为“1”以提供与旧版本的兼容性
对话框 假设如果脚本重定向标准输出，那
该“--标准输出"给出了选项。
使用 onworks.net 服务在线使用对话框
