Besturingselementen voor dialoogvensters in detail
- Werken met dialoogvensters
- Eigenschappen
- Gebeurtenissen
- Elementen voor beheer dialoogvenster
Apache OpenOffice BASIC herkent een bereik aan besturingselementen welke kunnen worden onderverdeeld in de volgende groepen:
| Invoervelden | Knoppen | Keuzelijsten | Anders |
|---|---|---|---|
|
|
|
|
Knoppen
Een knop voert een actie uit als u er op klikt.
Het eenvoudigste scenario voor de knop is om een gebeurtenis Actie uitvoeren te activeren als er op wordt gedrukt door een gebruiker. U kunt ook andere acties aan de knop koppelen om een dialoogvenster te sluiten met behulp van de eigenschap PushButtonType. Als u klikt op een knop die deze eigenschap heeft ingesteld op de waarde 0, wordt het dialoogvenster niet beïnvloed. Als u klikt op een knop die deze eigenschap heeft ingesteld op de waarde 1, wordt het dialoogvenster gesloten en de methode Execute van het dialoogvenster geeft de waarde 1 terug (dialoogvenster reeks is correct beëindigd). Als PushButtonType de waarde 2 heeft, wordt het dialoogvenster gesloten en de methode Execute van het dialoogvenster geeft de waarde 0 terug (dialoogvenster gesloten). In de editor voor dialoogvensters worden de waarden voor de eigenschappen symbolisch weergegeven als Standaard (0), OK (1), Annuleren (2) en Help (3).
Het volgende zijn alle eigenschappen die beschikbaar zijn via het model van de knop:
- Model.BackgroundColor (long)
- kleur van de achtergrond
- Model.DefaultButton (Boolean)
- De knop wordt gebruikt als standaardwaarde en reageert op de Entertoets indien hij niet de focus heeft
- Model.FontDescriptor (struct)
- structuur die de details van het lettertype dat moet worden gebruikt specificeert (overeenkomend met de structuur van com.sun.star.awt.FontDescriptor)
- Model.Label (String)
- label dat wordt weergegeven op de knop
- Model.Printable (Boolean)
- het besturingselement kan wordne afgedrukt
- Model.TextColor (Long)
- tekstkleur van het besturingselement
- Model.HelpText (String)
- Helptekst die wordt weergegeven wanneer u de muisaanwijzer over het besturingselement beweegt
- Model.HelpURL (String)
- URL van de online Help voor het overeenkomende besturingselement
- PushButtonType (short)
- actie die is gekoppeld aan aan de knop (0: geen actie, 1: OK, 2: Cancel 3: Help)
Radioknoppen
These buttons are generally used in groups and allow you to select from one of several options. When you select an option, all of the other options in the group are deactivated. This ensures that at any one time, only one option button is set.
An option button control element provides two properties:
- State (Boolean)
- activates the button
- Label (String)
- label that is displayed on the button
You can also use the following properties from the model of the option buttons:
- Model.FontDescriptor (struct)
- structure with details of the font to be used (in accordance with com.sun.star.awt.FontDescriptor)
- Model.Label (String)
- label that is displayed on the control element
- Model.Printable (Boolean)
- control element can be printed
- Model.State (Short)
- if this property is equal to 1, the option is activated, otherwise it is deactivated
- Model.TextColor (Long)
- text color of control element
- Model.HelpText (String)
- help text that is displayed when the mouse cursor rests over the control element
- Model.HelpURL (String)
- URL of online help for the corresponding control element
To combine several option buttons in a group, you must position them one after another in the activation sequence without any gaps (Model.TabIndex property, described as Order in the dialog editor). If the activation sequence is interrupted by another control element, then Apache OpenOffice automatically starts with a new control element group that can be activated regardless of the first group of control elements.
 |
VBA : Unlike VBA, you cannot insert option buttons in a group of control elements in Apache OpenOffice Basic. The grouping of control elements in Apache OpenOffice Basic is only used to ensure a visual division by drawing a frame around the control elements. |
Checkboxes
Checkboxes are used to record a Yes or No value and depending on the mode, they can adopt two or three states. In addition to the Yes and No states, a check box can have an in-between state if the corresponding Yes or No status has more than one meaning or is unclear.
Checkboxes provide the following properties:
- State (Short)
- state of the checkbox (0: no, 1: yes, 2: in-between state)
- Label (String)
- label for the control element
- enableTriState (Boolean)
- in addition to the activated and deactivated states, you can also use the in-between state
The model object of a checkbox provides the following properties:
- Model.FontDescriptor (struct)
- structure with details of the font used (in accordance with com.sun.star.awt.FontDescriptor structure)
- Model.Label (String)
- label for the control element
- Model.Printable (Boolean)
- the control element can be printed
- Model.State (Short)
- state of the checkbox (0: no, 1: yes, 2: in-between state)
- Model.Tabstop (Boolean)
- the control element can be reached with the Tab key
- Model.TextColor (Long)
- text color of control element
- Model.HelpText (String)
- help text that is displayed when you rest the mouse cursor over the control element
- Model.HelpURL (String)
- URL of online help for the corresponding control element
Text Fields
Text fields allow users to type numbers and text. The com.sun.star.awt.UnoControlEdit. service forms the basis for text fields.
A text field can contain one or more lines and can be edited or blocked for user entries. Text fields can also be used as special currency and numerical fields as well as screen fields for special tasks. As these control elements are based on the UnoControlEdit Uno service, their program-controlled handling is similar.
Text fields provide the following properties:
- Text (String)
- current text
- SelectedText (String)
- currently highlighted text
- Selection (Struct)
- read-only highlighting of details (structure in accordance with com.sun.star.awt.Selection, with the Min and Max properties to specify the start and end of the current highlighting)
- MaxTextLen (short)
- maximum number of characters that you can type in the field
- Editable (Boolean)
- True activates the option for entering text, False blocks the entry option (the property cannot be called up directly but only through IsEditable)
- IsEditable (Boolean)
- the content of the control element can be changed, read-only
The following properties are provided through the associated model object:
- Model.Align (short)
- orientation of text (0: left-aligned, 1: centered, 2: right-aligned)
- Model.BackgroundColor (long)
- color of the background of the control element
- Model.Border (short)
- type of border (0: no border, 1: 3D border, 2: simple border)
- Model.EchoChar (String)
- echo character for password fields
- Model.FontDescriptor (struct)
- structure with details of font used (in accordance with com.sun.star.awt.FontDescriptor structure)
- Model.HardLineBreaks (Boolean)
- automatic line breaks are permanently inserted in the control element text
- Model.HScroll (Boolean)
- the text has a horizontal scrollbar
- Model.MaxTextLen (Short)
- maximum length of text, where 0 corresponds to no length limit
- Model.MultiLine (Boolean)
- permits entry to spans several lines
- Model.Printable (Boolean)
- the control element can be printed
- Model.ReadOnly (Boolean)
- the content of the control element is read-only
- Model.Tabstop (Boolean)
- the control element can be reached with the Tab key
- Model.Text (String)
- text associate with the control element
- Model.TextColor (Long)
- text color of control element
- Model.VScroll (Boolean)
- the text has a vertical scrollbar
- Model.HelpText (String)
- help text that is displayed when the mouse cursor rests over the control element
- Model.HelpURL (String)
- URL of online help for the corresponding control element
List Boxes
List boxes (com.sun.star.awt.UnoControlListBox service) support the following properties:
- ItemCount (Short)
- number of elements, read-only
- SelectedItem (String)
- text of highlighted entry, read-only
- SelectedItems (Array Of Strings)
- data field with highlighted entries, read-only
- SelectedItemPos (Short)
- number of the entry highlighted at present, read-only
- SelectedItemsPos (Array of Short)
- data field with the number of highlighted entries (for lists which support multiple selection), read-only
- MultipleMode (Boolean)
- True activates the option for multiple selection of entries, False blocks multiple selections (the property cannot be called up directly but only through IsMultipleMode)
- IsMultipleMode (Boolean)
- permits multiple selection within lists, read-only
List boxes provide the following methods:
- addItem (Item, Pos)
- enters the string specified in the Item into the list at the Pos position
- addItems (ItemArray, Pos)
- enters the entries listed in the string's ItemArray data field into the list at the Pos position
- removeItems (Pos, Count)
- removes Count entries as of the Pos position
- selectItem (Item, SelectMode)
- activates or deactivates highlighting for the element specified in the string Item depending on the SelectMode Boolean variable
- makeVisible (Pos)
- scrolls through the list field so that the entry specified with Pos is visible
The model object of the list boxes provides the following properties:
- Model.BackgroundColor (long)
- background color of control element
- Model.Border (short)
- type of border (0: no border, 1: 3D border, 2: simple border)
- Model.FontDescriptor (struct)
- structure with details of font used (in accordance with com.sun.star.awt.FontDescriptor structure)
- Model.LineCount (Short)
- number of lines in control element
- Model.MultiSelection (Boolean)
- permits multiple selection of entries
- Model.SelectedItems (Array of Strings)
- list of highlighted entries
- Model.StringItemList (Array of Strings)
- list of all entries
- Model.Printable (Boolean)
- the control element can be printed
- Model.ReadOnly (Boolean)
- the content of the control element is read-only
- Model.Tabstop (Boolean)
- the control element can be reached with the Tab key
- Model.TextColor (Long)
- text color of control element
- Model.HelpText (String)
- automatically displayed help text which is displayed if the mouse cursor is above the control element
- Model.HelpURL (String)
- URL of online help for the corresponding control element
|
VBA : The VBA option for issuing list entries with a numerical additional value (ItemData) does not exist in Apache OpenOffice Basic. If you want to administer a numerical value (for example a database ID) in addition to the natural language text, you must create an auxiliary data field that administers in parallel to the list box. |
| Content on this page is licensed under the Public Documentation License (PDL). |
