Difference between revisions of "ZH/Documentation/BASIC Guide/Control Elements"
(New page: {{ZH/Documentation/BASICGuideTOC/v2 |ShowPrevNext=block |ShowPrevPage=block |PrevPage=Documentation/BASIC Guide/Events |NextPage=Documentation/BASIC Guide/Forms |dial=block }} {{DISPLAYTIT...) |
|||
Line 2: | Line 2: | ||
|ShowPrevNext=block | |ShowPrevNext=block | ||
|ShowPrevPage=block | |ShowPrevPage=block | ||
− | |PrevPage=Documentation/BASIC Guide/Events | + | |PrevPage=ZH/Documentation/BASIC Guide/Events |
− | |NextPage=Documentation/BASIC Guide/Forms | + | |NextPage=ZH/Documentation/BASIC Guide/Forms |
|dial=block | |dial=block | ||
}} | }} | ||
Line 172: | Line 172: | ||
{{PDL1}} | {{PDL1}} | ||
+ | {{InterWiki_Languages_BasicGuide|articletitle=Documentation/BASIC Guide/Control Elements}} | ||
{{InterWiki_Languages_BasicGuide|articletitle=Documentation/BASIC Guide/Control Elements}} | {{InterWiki_Languages_BasicGuide|articletitle=Documentation/BASIC Guide/Control Elements}} |
Revision as of 22:06, 12 December 2008
Apache OpenOffice Basic 能够识别一系列控制元素,这些元素可分为以下几组:
输入字段 | 按钮 | 选择列表 | 其他 |
---|---|---|---|
|
|
|
|
按钮
在单击按钮时,将会执行一项操作。
最简单的情况是,在用户单击按钮时触发 When Initiating 事件。也可以使用 PushButtonType 属性将另一个操作与按钮相关联,以打开一个对话框。如果您单击将该属性值设置为 0 的按钮,则对话框不受影响。如果您单击将该属性值设置为 1 的按钮,则会关闭对话框,并且对话框的 Execute 方法返回值 1(已正确结束对话框序列)。如果 PushButtonType 值为 2,则会关闭对话框,并且对话框的 Execute 方法返回值 0(已关闭对话框)。
下面是可通过按钮模型使用的所有属性:
- Model.BackgroundColor (long)
- 背景颜色
- Model.DefaultButton (Boolean)
- 该按钮用作默认值,并在没有焦点的情况下响应 Enter 键
- Model.FontDescriptor (struct)
- 指定要使用的字体详细信息的结构(与 com.sun.star.awt.FontDescriptor 结构一致)
- Model.Label (String)
- 按钮上显示的标签
- Model.Printable (Boolean)
- 可以打印控制元素
- Model.TextColor (Long)
- 控制元素的文本颜色
- Model.HelpText (String)
- 将鼠标光标移到控制元素上方时显示的帮助文本
- Model.HelpURL (String)
- 相应控制元素的联机帮助的 URL
- PushButtonType (short)
- 与按钮关联的操作(0:无操作,1:确定,2:取消)
选项按钮
这些按钮通常是成组使用的,可用于从几个选项中选择一个选项。在选择某个选项后,将会停用该组中的所有其他选项。这可确保每次仅设置一个选项按钮。
选项按钮控制元素提供了以下两个属性:
- State (Boolean)
- 激活按钮
- Label (String)
- 按钮上显示的标签
也可以使用选项按钮模型中的以下属性:
- Model.FontDescriptor (struct)
- 包含要使用的字体详细信息的结构(与 com.sun.star.awt.FontDescriptor 一致)
- Model.Label (String)
- 控制元素上显示的标签
- Model.Printable (Boolean)
- 可以打印控制元素
- Model.State (Short)
- 如果该属性等于 1,则会激活该选项,否则停用该选项
- Model.TextColor (Long)
- 控制元素的文本颜色
- Model.HelpText (String)
- 将鼠标光标置于控制元素上方时显示的帮助文本
- Model.HelpURL (String)
- 相应控制元素的联机帮助的 URL
要将几个选项按钮合并为一个组,必须在激活序列中依次放置这些按钮,确保它们之间没有任何间隔(Model.TabIndex 属性,如对话框编辑器中的“排序”所述)。如果其他控制元素中断了激活序列,Apache OpenOffice 将会自动启动一个可激活的新控制元素组,而不管第一个控制元素组为何种情况。
复选框
复选框用于记录值“是”或“否”值,根据使用的模式,它们可以采用两种或三种状态。除了“是”和“否”状态之外,如果相应的“是”或“否”状态具有多种含义或含糊不明确,复选框还可以具有一种中间状态。
复选框提供了以下属性:
- State (Short)
- 复选框的状态(0:否,1:是,2:中间状态)
- Label (String)
- 控制元素的标签
- enableTriState (Boolean)
- 除了激活和停用状态之外,您还可以使用中间状态
复选框的模型对象提供了以下属性:
- Model.FontDescriptor (struct)
- 包含所使用的字体详细信息的结构(与 com.sun.star.awt.FontDescriptor 结构一致)
- Model.Label (String)
- 控制元素的标签
- Model.Printable (Boolean)
- 可以打印控制元素
- Model.State (Short)
- 复选框的状态(0:否,1:是,2:中间状态)
- Model.Tabstop (Boolean)
- 可通过 Tab 键访问控制元素
- Model.TextColor (Long)
- 控制元素的文本颜色
- Model.HelpText (String)
- 将鼠标光标置于控制元素上方时显示的帮助文本
- Model.HelpURL (String)
- 相应控制元素的联机帮助的 URL
文本字段
用户可通过文本字段键入数字和文本。com.sun.star.awt.UnoControlEdit. 服务是文本字段的基础。
文本字段可以包含一行或多行,可以对文本字段进行编辑,或禁止用户在其中输入内容。文本字段还可以用作特殊货币和数值字段,以及用作屏幕字段以完成特殊任务。由于这些控制元素都基于 UnoControlEdit Uno 服务,它们的程序控制处理方式非常相似。
文本字段提供了以下属性:
- Text (String)
- 当前文本
- SelectedText (String)
- 当前突出显示的文本
- Selection (Struct)
- 以只读方式突出显示的详细信息(与 com.sun.star.awt.Selection 一致的结构,并使用 Min 和 Max 属性指定当前突出显示文本的开头和结尾)
- MaxTextLen (short)
- 可以在字段中键入的最大字符数
- Editable (Boolean)
- True 会激活输入文本的选项,False 会阻止输入选项(无法直接调用该属性,而只能通过 IsEditable 进行调用)
- IsEditable (Boolean)
- 可以更改控制元素的内容,只读
可通过关联的模型对象提供以下属性:
- Model.Align (short)
- 文本方向(0:左对齐,1:居中,2:右对齐)
- Model.BackgroundColor (long)
- 控制元素的背景颜色
- Model.Border (short)
- 边框类型(0:无边框,1:三维边框,2:简单边框)
- Model.EchoChar (String)
- 密码字段的回显字符
- Model.FontDescriptor (struct)
- 包含所使用的字体详细信息的结构(与 com.sun.star.awt.FontDescriptor 结构一致)
- Model.HardLineBreaks (Boolean)
- 在控制元素文本中永久插入自动换行符
- Model.HScroll (Boolean)
- 文本具有水平滚动条
- Model.MaxTextLen (Short)
- 最大文本长度,值 0 表示无长度限制
- Model.MultiLine (Boolean)
- 允许条目占据多行
- Model.Printable (Boolean)
- 可以打印控制元素
- Model.ReadOnly (Boolean)
- 控制元素的内容为只读
- Model.Tabstop (Boolean)
- 可通过 Tab 键访问控制元素
- Model.Text (String)
- 与控制元素关联的文本
- Model.TextColor (Long)
- 控制元素的文本颜色
- Model.VScroll (Boolean)
- 文本具有垂直滚动条
- Model.HelpText (String)
- 将鼠标光标置于控制元素上方时显示的帮助文本
- Model.HelpURL (String)
- 相应控制元素的联机帮助的 URL
列表框
列表框(com.sun.star.awt.UnoControlListBox 服务)支持以下属性:
- ItemCount (Short)
- 元素数目,只读
- SelectedItem (String)
- 突出显示条目的文本,只读
- SelectedItems (Array Of Strings)
- 包含突出显示条目的数据字段,只读
- SelectItemPos (Short)
- 当前突出显示的条目数目,只读
- SelectItemsPos (Array of Short)
- 包含突出显示的条目数目的数据字段(适用于支持多重选择的列表),只读
- MultipleMode (Boolean)
- True 会激活条目多重选择选项,False 会阻止多重选择(无法直接调用该属性,而只能通过 IsMultipleMode 进行调用)
- IsMultipleMode (Boolean)
- 允许在列表中进行多重选择,只读
列表框提供了以下方法:
- addItem (Item, Pos)
- 在列表中的 Pos 位置输入 Item 中指定的字符串
- addItems (ItemArray, Pos)
- 在列表中的 Pos 位置输入字符串的 ItemArray 数据字段中列出的条目
- removeItems (Pos, Count)
- 从 Pos 位置开始删除 Count 个条目
- selectItem (Item, SelectMode)
- 根据 SelectMode 布尔变量,启用或禁用字符串 Item 中指定元素的突出显示
- makeVisible (Pos)
- 滚动列表字段,以便显示通过 Pos 指定的条目
列表框的模型对象提供了以下属性:
- Model.BackgroundColor (long)
- 控制元素的背景颜色
- Model.Border (short)
- 边框类型(0:无边框,1:三维边框,2:简单边框)
- Model.FontDescriptor (struct)
- 包含所使用的字体详细信息的结构(与 com.sun.star.awt.FontDescriptor 结构一致)
- Model.LineCount (Short)
- 控制元素中的行数
- Model.MultiSelection (Boolean)
- 允许进行条目多重选择
- Model.SelectedItems (Array of Strings)
- 突出显示条目的列表
- Model.StringItemList (Array of Strings)
- 所有条目的列表
- Model.Printable (Boolean)
- 可以打印控制元素
- Model.ReadOnly (Boolean)
- 控制元素的内容为只读
- Model.Tabstop (Boolean)
- 可通过 Tab 键访问控制元素
- Model.TextColor (Long)
- 控制元素的文本颜色
- Model.HelpText (String)
- 将鼠标光标置于控制元素上方时自动显示的帮助文本
- Model.HelpURL (String)
- 相应控制元素的联机帮助的 URL
Content on this page is licensed under the Public Documentation License (PDL). |