目录
索引 🔎︎

# 常规

为选中的控件或对话框定义属性。可供选择的属性取决于选择的控件类型，因此以下属性并不适用于每种类型的控件。

## 按钮类型

选择按钮类型。按钮类型决定启动什么类型的操作。

## 帮助 URL

指定当焦点位于特定控件上时，按 F1 所调用的帮助 URL。例如，使用 HID:1234 格式可以调用编号为 1234 的 Help-ID。

把环境变量 HELP_DEBUG 的值设为 1，以查看扩展提示信息 Help-ID。

## 帮助文本

输入帮助文本，当鼠标停留在控件上时，该文本将显示为提示 (气泡式帮助)。

## 背景颜色

指定当前控件的背景颜色。

## 编辑掩码

指定模式控件的编辑掩码。编辑掩码是用于定义控件输入格式的字符代码。

对于编辑掩码的每个输入字符，您必须指定一个掩码字符来限定只能输入表格中给定的数值:

字符 | 含义
--- | ---
L | 文字常数。用户不能修改该字符。
a | 此处可以输入字符 a 到 z。如果输入了大写字母，将被自动转换成小写字母。
A | 可以在此处输入字符 A-Z。如果输入小写字母，则会自动将其转换为大写字母
c | 此处可以输入字符 a 到 z 和 0 到 9。如果输入了大写字母，将被自动转换成小写字母。
C | 可以在此处输入字符 a-z 以及 0-9。如果输入小写字母，则会自动将其转换为大写字母
N | 只能输入字符 0 到 9。
x | 可以输入所有可打印的字符。
X | 可以输入所有可打印的字符。如果输入了小写字母，将被自动转换成大写字母。

## 边框

指定当前控件的边框类型。

## 标签

指定当前控件的标签。标签将随控件一同显示。

使用「Shift+Enter 键在标签中插入手动换行符，可以创建多行标签」。

## 标题

指定对话框的标题。点击对话框的边框可以选择该对话框。

「标题仅用于为对话框加上标签，并且只能含有一行文字。请注意，如果使用宏进行操作，则只能通过 Name」属性调用控件。

## 打印

选择「是」将在文档的打印输出中包含当前控件。

## 大的变化

指定当用户点击滚动条上滑块与箭头之间的区域时所滚动的单位数。

## 调节按钮

选择「是」可以将数值调节钮添加到数字、货币、日期或时间控件，以便使用箭头按钮来增加或减少输入值。

## 调用停止模式编辑

当编辑操作因选择树中的另一个节点、或因树中数据发生变化、或因其他原因而中断时，指定所要执行的操作。

将该属性值设为 TRUE ，编辑中断时可以使修改被自动保存；设为 FALSE 则意味着编辑被取消，且修改丢失。

默认值为 FALSE。

## 对齐

指定选中控件的对齐选项。

## 多行输入

选择「是」允许在控件中输入多行文本。按 Enter 可以在控件中插入手动换行符。

## 多重选择

选择「是」将允许在列表控件中选择多个条目。

## 方向

指定滚动条控件的方向。

## 高度

指定当前控件或对话框的高度。

## 滚动数值

指定滚动条控件的初始值。此值用于确定滚动条滑块的位置。

## 滚动条

将指定的滚动条类型添加到文本框。

## 滚动条

将指定的滚动条类型添加到文本框。

## 行高

指定树控件每一行的高度，单位为像素。

如果给定的值小于或等于 0，则该行为所有行中最高的行。

默认值为 0。

## 行数

输入列表控件要显示的行数。对于组合框，此设置只在启用下拉选项时有效。

## 货币符号

输入要用于货币控件的货币符号。

## 检查格式

选择「是」只允许在数字、货币、日期或时间控件中输入有效字符。

## 进度值

指定进度条控件的进度值。

## 可编辑的

指定树控件的节点是否可编辑。

默认值为 FALSE。

## 可见大小

指定滚动条控件的滑块长度。

## 宽度

指定当前控件或对话框的宽度。

## 列表条目

指定列表控件的条目。一个列表条目占一行。按「Shift+Enter」组合键可以插入一个新行。

## 密码字符

输入要显示的字符，这些字符将取代实际输入的字符。这可以用于在文本控件中输入密码。

## 名称

插入当前控件的名称。此名称用于标识控件。

## 默认按钮

选择「是」将使当前按钮控件成为默认选项。在对话框中按「Return」键将激活默认按钮。

## 启用

选择「是」可启用控件。如果控件被禁用，将在对话框中以灰色显示。

## 千位分隔符

选择「是」将在数字控件或货币控件中显示千位分隔符。

## 前缀符号

选择「是」将在输入数字时在货币控件中显示货币符号前缀。

## 区间

指定微调按钮控件的递增和递减间隔。

## 日期

指定要在日期控件中显示的默认日期。

## 日期格式

指定日期控件所需的格式。日期控件将根据此格式设置来解释用户输入的内容。

## 三重状态

选择「是」可以使复选框具有三种状态 (选中、未选中和灰显)，否则只有两种状态 (选中和未选中)。

## 时间格式

选择要用于时间控件的格式。

## 手动换行

选择「是」将允许在多行控件中使用手动换行符。

## 数值

指定当前控件的值。

## 顺序

指定在对话框中按 Tab 键时控件获得焦点的顺序。刚进入对话框时，具有最小顺序号 (0) 的控件将获得焦点。连续按「Tab」键时，其余控件将按照各自的顺序号依次获得焦点。

首先，控件的顺序号取决于它们添加到对话框中的顺序。您可以更改控件的顺序号。LibreOffice Basic 会自动更新顺序号，以避免编号重复。对不能获得焦点的控件也指定了顺序号，但是在使用 Tab 键时将跳过这些控件。

## 缩放

调整图像比例，以符合控件大小。

## 图形

为按钮或图像控件指定图形来源。点击 "..." 可选择文件。

## 位置 X

指定当前控件到对话框左边缘的距离。

## 位置 Y

指定当前控件到对话框顶部的距离。

## 下拉

选择「是」将对列表框或组合框控件启用下拉选项。下拉控件字段包含一个箭头按钮，通过点击该按钮可以打开现有表单条目的列表。

## 显示根

指定是否显示树控件的根节点。

如果将「显示根」设为 FALSE，则对树控件而言，模型的根节点将不再是一个有效节点，且不能被 XTreeControl 的任何方法所使用。

默认值为 TRUE。

## 显示根图柄

指定这些节点图柄是否也显示在根级别。

默认值为 TRUE。

## 显示图柄

指定是否显示该节点的图柄。

这些图柄是使树控件分级显示的虚线。

默认值为 TRUE。

## 小的变化

指定当用户点击滚动条上的箭头时所滚动的单位数。

## 小数点位数

指定数字控件或货币控件所显示的小数位数。

## 选择

指定选中项的顺序，其中 "0" 表示第一项。要选择多个项，必须启用「多重选择」。

点击「...」按钮打开「选择」对话框。

点击要选择的项。要选择多个项，请确保选择「多重选择」选项。

## 选择类型

指定为该树控件激活的选择模式。

## 延迟

指定滚动条触发事件之间的延迟时间 (以毫秒为单位)。点击滚动条箭头或滚动条中的背景区域时，将会发生触发事件。如果在点击滚动条箭头或滚动条中的背景区域时按住鼠标按钮不放，将会发生重复的触发事件。如果需要，可以在输入的数字后面加上有效的时间单位，例如 2 s 或 500 ms。

## 页 (步)

指定分配了当前控件的对话框页码，或者要编辑的对话框的页码。如果对话框只有一页，则将其「页 (步)」的值设置为「0」。

选择页 (步) = 0 将使每个对话框页面中均能看到当前控件。

要于运行时在对话框页面之间进行切换，需要创建一个修改「页 (步)」的值的宏。

## 只读

选择「是」可阻止用户编辑当前控件的值。控件处于启用状态，并可以获得焦点，但无法对其进行修改。

## 制表位

选择当使用「Tab」键时当前控件的焦点行为。

默认 | 使用「Tab」键定位时，只有输入控件能接收焦点。没有输入框的控件，如标题控件将被略过。
否 | 当使用 Tab 键切换焦点时，跳过当前控件。
是 | 使用 Tab 键可以选择控件。

## 重复

如果在控件 (如微调按钮) 上按住鼠标按钮不放，将会发生重复的触发事件。

## 状态

指定当前控件的选择状态。

## 字符集

选择要用于显示当前控件内容的字体。

## 字符掩码

指定要在模式控件中显示的初始值。这可以帮助用户确定模式控件中允许使用的值。字符掩码受编辑掩码所指定的格式的限制。

## 自动填充

选择「是」将对选中的控件启用自动填充功能。

## 最长的文字

指定用户可以输入的最大字符数。

## 最长日期。

指定日期控件的上限。

## 最长时间。

指定时间控件的最大时间值。

## 最大滚动值。

指定滚动条控件的最大值。

## 最大进度值。

指定进度条控件的最大值。

## 最大数值。

指定当前控件的最大值。

## 最短日期。

指定日期控件的下限。

## 最短时间。

指定时间控件的最小时间值。

## 最小滚动值。

指定滚动条控件的最小值。

## 最小进度值。

指定进度条控件的最小值。

## 最小数值。

指定当前控件的最小值。