Difference between revisions of "NL/Documentation/BASIC Guide/Control Elements"

Revision as of 16:16, 18 March 2013

Programmeursgids voor BASIC

{{{parttitle}}}

[[{{{PrevPart}}}|< Vorige deel ]]

[[{{{NextPart}}}|Volgende deel >]]

• De taal van Apache OpenOffice Basic

• Overzicht van een programma in BASIC
• Werken met variabelen
• Tekenreeksen
• Getallen
• Booleaanse waarden
• Datum en tijd
• Arrays
• Bereik en levensduur van variabelen
• Constanten
• Operatoren
• Aftakken
• Loops
• Procedures en functies
• Foutafhandeling
• Andere instructies

• Runtime-bibliotheek

• Functies voor conversie
• Strings (Tekenreeksen)
• Datum en tijd
• Bestanden en mappen
• Bericht- en invoervakken
• Andere functies

• Introductie voor de API

• Universal Network Objects (UNO)
• Eigenschappen en methoden
• Modules, services en interfaces
• Gereedschap voor werken met UNO
• Overzicht van centrale interfaces

• Werken met documenten

• De StarDesktop
• Opmaakprofielen en sjablonen

• Tekstdocumenten

• De structuur van tekstdocumenten
• Tekstdocumenten bewerken
• Meer dan alleen tekst

• Werkbladdocumenten

• De structuur van werkbladdocumenten
  • Rijen en kolommen
  • Cellen en bereiken
  • Werkbladdocumenten opmaken
• Werkbladdoucmenten bewerken

• Tekeningen en presentaties

• De structuur van tekeningen
• Tekenobjecten bewerken
• Presentaties

• Grafieken (Diagrammen)

• Diagrammen gebruiken in werkbladen
• De structuur van diagrammen
• Typen diagram

• Databases

• SQL: een Query-taal
• Typen toegang tot database
• Gegevensbronnen
• Toegang tot database

• Dialoogvensters

• Werken met dialoogvensters
• Eigenschappen
• Gebeurtenissen
• Elementen voor beheer dialoogvenster

• Formulieren

• Werken met formulieren
• Besturingselementen Formulieren
• Database-formulieren

< Vorige pagina

Volgende pagina >

Apache OpenOffice BASIC herkent een bereik aan besturingselementen welke kunnen worden onderverdeeld in de volgende groepen:

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.

VBA : Anders dan in VBA kunt u geen radioknoppen invoegen in een groep besturingselementen in Apache OpenOffice BASIC. Het groeperen van besturingselementen in Apache OpenOffice BASIC wordt alleen gebruikt om een visuele scheiding te verzorgen door een kader rond de besturingselementen te tekenen.

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

Keuzelijsten (service com.sun.star.awt.UnoControlListBox) ondersteunen de volgende eigenschappen:

ItemCount (Short)

aantal elementen, alleen-lezen

SelectedItem (String)

tekst van geaccentueerde invoer, alleen-lezen

SelectedItems (Array Of Strings)

gegevensveld met geaccentueerde items, alleen-lezen

SelectedItemPos (Short)

aantal van de thans geaccentueerde items, alleen-lezen

SelectedItemsPos (Array of Short)

gegevensveld met het aantal geaccentueerde items (voor lijsten die meervoudige selecties ondersteunen), alleen-lezen

MultipleMode (Boolean)

True activeert de optie voor meervoudige selectie van items, False blokkeert meervoudige selecties (de eigenschap kan niet direct worden aangeroepen, maar alleen via IsMultipleMode)

IsMultipleMode (Boolean)

staat meervoudige selectie binnen lijsten toe, alleen-lezen

Keuzelijsten verschaffen de volgende methoden:

addItem (Item, Pos)

voert de in Item gespecificeerde tekst in de lijst in op de positie Pos

addItems (ItemArray, Pos)

voert de in de tekenreeks van gegevensveld ItemArray ingevoerde items in de lijst in op de positie Pos

removeItems (Pos, Count)

verwijdert Count items van de positie Pos

selectItem (Item, SelectMode)

activeert of deactiveert accentuering voor het element dat is gespecificeerd in de tekenreeks Item afhankelijk van de Booleaanse variabele van SelectMode

makeVisible (Pos)

scrollt door het lijstveld zodat het met Pos gespecificeerde item zichtbaar is

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.