Difference between revisions of "NL/Documentation/BASIC Guide/Control Elements"
Line 25: | Line 25: | ||
* Radioknoppen | * Radioknoppen | ||
| | | | ||
− | * | + | * Keuzelijsten |
− | * | + | * Keuzelijsten met invoerveld |
* [[Going_further_with_Dialog_and_Component#The_New_Tree_Control|Boomstructuur]] | * [[Going_further_with_Dialog_and_Component#The_New_Tree_Control|Boomstructuur]] | ||
| | | | ||
Line 94: | Line 94: | ||
;<tt>Model.Printable (Boolean)</tt>:besturingselement kan worden afgedrukt | ;<tt>Model.Printable (Boolean)</tt>:besturingselement kan worden afgedrukt | ||
;<tt>Model.State (Short)</tt>:status van het keuzevak (0: nee, 1: ja, 2: status tussenin) | ;<tt>Model.State (Short)</tt>:status van het keuzevak (0: nee, 1: ja, 2: status tussenin) | ||
− | ;<tt>Model.Tabstop (Boolean)</tt>:het besturingselement kan | + | ;<tt>Model.Tabstop (Boolean)</tt>:het besturingselement kan worden bereikt met de Tabtoets |
;<tt>Model.TextColor (Long)</tt>:tekstkleur van het besturingselement | ;<tt>Model.TextColor (Long)</tt>:tekstkleur van het besturingselement | ||
;<tt>Model.HelpText (String)</tt>:Helptekst die wordt weergegeven als de muisaanwijzer boven het besturingselement staat | ;<tt>Model.HelpText (String)</tt>:Helptekst die wordt weergegeven als de muisaanwijzer boven het besturingselement staat | ||
Line 101: | Line 101: | ||
== Tekstvelden == | == Tekstvelden == | ||
− | + | Tekstvelden staan gebruikers toe getallen en tekst in te voeren. De service <idl>com.sun.star.awt.UnoControlEdit.</idl>vormt de basis voor tekstvelden. | |
− | + | Een tekstveld kan één of meer regels bevatten en kan worden bewerkt of geblokkeerd voor gebruikers-invoer. Tekstvelden kunnen ook worden gebruikt als speciale valuta en numerieke velden en ook als schermvelden voor speciale taken. Omdat deze besturingselementen zijn gebaseerd op de Uno-service <tt>UnoControlEdit</tt>, komt hun programma-gecontroleerde behandeling overeen. | |
− | + | Tekstvelden verschaffen de volgende eigenschappen: | |
− | ;<tt>Text (String)</tt>: | + | ;<tt>Text (String)</tt>:huidige tekst |
− | ;<tt>SelectedText (String)</tt>: | + | ;<tt>SelectedText (String)</tt>:momenteel geaccentueerde tekst |
− | ;<tt>Selection (Struct)</tt>: | + | ;<tt>Selection (Struct)</tt>:alleen-lezen accentuering van details (structuur overeenkomend met <idl>com.sun.star.awt.Selection</idl> met de eigenschappen <tt>Min</tt> en <tt>Max</tt> om het begin en einde van de accentuering te specificeren) |
− | ;<tt>MaxTextLen (short)</tt>: | + | ;<tt>MaxTextLen (short)</tt>:maximale aantal tekens dat kan worden ingevoerd in het veld |
− | ;<tt>Editable (Boolean)</tt>:<tt>True</tt> | + | ;<tt>Editable (Boolean)</tt>:<tt>True</tt> activeert de optie om tekst in te voeren, <tt>False</tt> blokkeert de optie voor invoer (de eigenschap kan niet direct worden aangeroepen, maar alleen via <tt>IsEditable</tt>) |
− | ;<tt>IsEditable (Boolean)</tt>: | + | ;<tt>IsEditable (Boolean)</tt>:de inhoud van het besturingselement kan worden gewijzigd, alleen-lezen |
− | + | De volgende eigenschappen worden verschaft via het geassocieerde object model: | |
− | ;<tt>Model.Align (short)</tt>: | + | ;<tt>Model.Align (short)</tt>:oriëntatie van de tekst (0: links uitgelijnd, 1: gecentreerd, 2: rechts uitgelijnd) |
− | ;<tt>Model.BackgroundColor (long)</tt>: | + | ;<tt>Model.BackgroundColor (long)</tt>:achtergrondkleur van het besturingselement |
− | ;<tt>Model.Border (short)</tt>:type | + | ;<tt>Model.Border (short)</tt>:type rand (0: geen rand, 1: 3D-rand, 2: eenvoudige rand) |
− | ;<tt>Model.EchoChar (String)</tt>:echo | + | ;<tt>Model.EchoChar (String)</tt>:echo-teken voor velden met wachtwoorden |
− | ;<tt>Model.FontDescriptor (struct)</tt>: | + | ;<tt>Model.FontDescriptor (struct)</tt>:structuur met details van het lettertype dat moet worden gebruikt (overeenkomend met <idl>com.sun.star.awt.FontDescriptor</idl>) |
− | ;<tt>Model.HardLineBreaks (Boolean)</tt>: | + | ;<tt>Model.HardLineBreaks (Boolean)</tt>:automatische regeleinden worden permanent ingevoegd in de tekst van het besturingselement |
− | ;<tt>Model.HScroll (Boolean)</tt>: | + | ;<tt>Model.HScroll (Boolean)</tt>:de tekst heeft een horizontale schuifbalk |
− | ;<tt>Model.MaxTextLen (Short)</tt>: | + | ;<tt>Model.MaxTextLen (Short)</tt>:maximale lengte van de tekst, waar 0 overeenkomt met geen beperking van de lengte |
− | ;<tt>Model.MultiLine (Boolean)</tt>: | + | ;<tt>Model.MultiLine (Boolean)</tt>:staat invoer toe die meerdere regels beslaat |
− | ;<tt>Model.Printable (Boolean)</tt>: | + | ;<tt>Model.Printable (Boolean)</tt>:het besturingselement kan worden afgedrukt |
− | ;<tt>Model.ReadOnly (Boolean)</tt>: | + | ;<tt>Model.ReadOnly (Boolean)</tt>:de inhoud van het besturingselement is alleen-lezen |
− | ;<tt>Model.Tabstop (Boolean)</tt>: | + | ;<tt>Model.Tabstop (Boolean)</tt>:het besturingselement kan worden bereikt met de Tabtoets |
− | ;<tt>Model.Text (String)</tt>: | + | ;<tt>Model.Text (String)</tt>:tekst geassocieerd met het besturingselement |
− | ;<tt>Model.TextColor (Long)</tt>: | + | ;<tt>Model.TextColor (Long)</tt>:tekstkleur van het besturingselement |
− | ;<tt>Model.VScroll (Boolean)</tt>: | + | ;<tt>Model.VScroll (Boolean)</tt>:de tekst heeft een verticale schuifbalk |
− | ;<tt>Model.HelpText (String)</tt>: | + | ;<tt>Model.HelpText (String)</tt>:Helptekst die wordt weergegeven als u de muisaanwijzer op het besturingselement laat rusten |
− | ;<tt>Model.HelpURL (String)</tt>:URL | + | ;<tt>Model.HelpURL (String)</tt>:URL van de online Help voor het overeenkomende besturingselement |
− | == | + | == Keuzelijsten == |
List boxes (<idl>com.sun.star.awt.UnoControlListBox</idl> service) support the following properties: | List boxes (<idl>com.sun.star.awt.UnoControlListBox</idl> service) support the following properties: |
Revision as of 16:04, 18 March 2013
- 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 worden 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: Annuleren, 3: Help)
Radioknoppen
Deze knoppen worden in het algemeen in groepen gebruikt en stellen u in staat één of meerdere opties te selecteren. Als u een optie selecteert, worden alle andere opties in de groep gedeactiveerd. Dit zorgt er ten alle tijde voor dat slechts één optie is ingesteld.
Een besturingselement radioknop verschaft twee eigenschappen:
- State (Boolean)
- activeert de knop
- Label (String)
- label dat wordt weergegeven naast de knop
U kunt ook de volgende eigenschappen gebruiken van het model van de radioknoppen:
- Model.FontDescriptor (struct)
- structuur met details van het lettertype dat moet worden gebruikt (overeenkomend met com.sun.star.awt.FontDescriptor)
- Model.Label (String)
- label dat wordt weergegeven op het besturingselement
- Model.Printable (Boolean)
- besturingselement kan worden afgedrukt
- Model.State (Short)
- als deze eigenschap gelijk is aan 1 wordt de optie geactiveerd, anders wordt hij gedeactiveerd
- Model.TextColor (Long)
- tekstkleur van het besturingselement
- Model.HelpText (String)
- Helptekst die wordt weergegeven als de muisaanwijzer boven het besturingselement staat
- Model.HelpURL (String)
- URL van de online Help voor het overeenkomende besturingselement
U moet ze één voor één in de reeks van activering opgeven zonder een gat er tussen (eigenschap Model.TabIndex, beschreven als Volgorde van activering in de dialoogvenster-editor) om verschillende radioknoppen in een groep te combineren. Als de reeks van activering wordt onderbroken door een ander besturingselement, dan start Apache OpenOffice automatisch met een nieuwe groep besturingselementen die kan worden geactiveerd, ongeacht de eerste groep besturingselementen.
Keuzevakken
Keuzevakken worden gebruikt om een waarde Ja of Nee op te nemen en, afhankelijk van de modus, kunnen zij twee of drie statussen aannemen. In aanvulling op de statussen Ja en Nee, kan een keuzevak een tussen-in status hebben als de overeenkomende status Ja of Nee meer dan één bedoeling heeft of niet duidelijk is.
Keuzevakken verschaffen de volgende eigenschappen:
- State (Short)
- status van het keuzevak (0: nee, 1: ja, 2: status tussenin)
- Label (String)
- label voor het besturingselement
- enableTriState (Boolean)
- in aanvulling op de geactiveerd en gedeactiveerd status, kunt u ook de status tussenin gebruiken
Het object model van een keuzevak verschaft de volgende eigenschappen:
- Model.FontDescriptor (struct)
- structuur met details van het lettertype dat moet worden gebruikt (overeenkomend met com.sun.star.awt.FontDescriptor)
- Model.Label (String)
- label dat wordt weergegeven op het besturingselement
- Model.Printable (Boolean)
- besturingselement kan worden afgedrukt
- Model.State (Short)
- status van het keuzevak (0: nee, 1: ja, 2: status tussenin)
- Model.Tabstop (Boolean)
- het besturingselement kan worden bereikt met de Tabtoets
- Model.TextColor (Long)
- tekstkleur van het besturingselement
- Model.HelpText (String)
- Helptekst die wordt weergegeven als de muisaanwijzer boven het besturingselement staat
- Model.HelpURL (String)
- URL van de online Help voor het overeenkomende besturingselement
Tekstvelden
Tekstvelden staan gebruikers toe getallen en tekst in te voeren. De service com.sun.star.awt.UnoControlEdit.vormt de basis voor tekstvelden.
Een tekstveld kan één of meer regels bevatten en kan worden bewerkt of geblokkeerd voor gebruikers-invoer. Tekstvelden kunnen ook worden gebruikt als speciale valuta en numerieke velden en ook als schermvelden voor speciale taken. Omdat deze besturingselementen zijn gebaseerd op de Uno-service UnoControlEdit, komt hun programma-gecontroleerde behandeling overeen.
Tekstvelden verschaffen de volgende eigenschappen:
- Text (String)
- huidige tekst
- SelectedText (String)
- momenteel geaccentueerde tekst
- Selection (Struct)
- alleen-lezen accentuering van details (structuur overeenkomend met com.sun.star.awt.Selection met de eigenschappen Min en Max om het begin en einde van de accentuering te specificeren)
- MaxTextLen (short)
- maximale aantal tekens dat kan worden ingevoerd in het veld
- Editable (Boolean)
- True activeert de optie om tekst in te voeren, False blokkeert de optie voor invoer (de eigenschap kan niet direct worden aangeroepen, maar alleen via IsEditable)
- IsEditable (Boolean)
- de inhoud van het besturingselement kan worden gewijzigd, alleen-lezen
De volgende eigenschappen worden verschaft via het geassocieerde object model:
- Model.Align (short)
- oriëntatie van de tekst (0: links uitgelijnd, 1: gecentreerd, 2: rechts uitgelijnd)
- Model.BackgroundColor (long)
- achtergrondkleur van het besturingselement
- Model.Border (short)
- type rand (0: geen rand, 1: 3D-rand, 2: eenvoudige rand)
- Model.EchoChar (String)
- echo-teken voor velden met wachtwoorden
- Model.FontDescriptor (struct)
- structuur met details van het lettertype dat moet worden gebruikt (overeenkomend met com.sun.star.awt.FontDescriptor)
- Model.HardLineBreaks (Boolean)
- automatische regeleinden worden permanent ingevoegd in de tekst van het besturingselement
- Model.HScroll (Boolean)
- de tekst heeft een horizontale schuifbalk
- Model.MaxTextLen (Short)
- maximale lengte van de tekst, waar 0 overeenkomt met geen beperking van de lengte
- Model.MultiLine (Boolean)
- staat invoer toe die meerdere regels beslaat
- Model.Printable (Boolean)
- het besturingselement kan worden afgedrukt
- Model.ReadOnly (Boolean)
- de inhoud van het besturingselement is alleen-lezen
- Model.Tabstop (Boolean)
- het besturingselement kan worden bereikt met de Tabtoets
- Model.Text (String)
- tekst geassocieerd met het besturingselement
- Model.TextColor (Long)
- tekstkleur van het besturingselement
- Model.VScroll (Boolean)
- de tekst heeft een verticale schuifbalk
- Model.HelpText (String)
- Helptekst die wordt weergegeven als u de muisaanwijzer op het besturingselement laat rusten
- Model.HelpURL (String)
- URL van de online Help voor het overeenkomende besturingselement
Keuzelijsten
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
Content on this page is licensed under the Public Documentation License (PDL). |