对话框控制元素详述

From Apache OpenOffice Wiki
Jump to: navigation, search
doc OOo
Book.png


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 将会自动启动一个可激活的新控制元素组,而不管第一个控制元素组为何种情况。

Documentation note.png 与 VBA 不同,不能在 Apache OpenOffice Basic 的控制元素组中插入选项按钮。在 Apache OpenOffice Basic 中,控制元素组合仅用于通过在控制元素周围绘制框架来确保可视分区。

复选框

复选框用于记录值“是”或“否”值,根据使用的模式,它们可以采用两种或三种状态。除了“是”和“否”状态之外,如果相应的“是”或“否”状态具有多种含义或含糊不明确,复选框还可以具有一种中间状态。

复选框提供了以下属性:

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 一致的结构,并使用 MinMax 属性指定当前突出显示文本的开头和结尾)
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
Documentation note.png VBA 提供了发出包含附加数值 (ItemData) 的列表条目的选项,Apache OpenOffice Basic 中没有对应的选项。除了自然语言文本以外,如果还要管理数值(例如数据库 ID),则除了创建列表框以外,还必须创建用于管理的辅助数据字段。
Content on this page is licensed under the Public Documentation License (PDL).
Personal tools