Besturingselementen voor formulieren in detail

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 >

De beschikbare besturingselementen in formulieren zijn gelijk aan die van die in dialoogvensters. De selectie reikt van eenvoudige tekstvelden via keuzelijsten en combinatievakken tot diverse knoppen.

Hieronder vindt u een lijst met de meest belangrijke eigenschappen voor besturingselementen voor formulieren. Alle eigenschappen vormen een deel van de geassocieerde model-objecten.

In aanvulling op de standaard besturingselementen, is ook een tabel-controleveld-element beschikbaar voor formulieren, welke de complete medewerking van gegevensbron-tabellen toestaat. Dit wordt beschreven in het gedeelte Gegevensbron Formulieren in hoofdstuk Database-formulieren.

Knoppen

Het model-object van een besturingselement Knop verschaft de volgende eigenschappen:

BackgroundColor (long)

achtergrondkleur

DefaultButton (Boolean)

de knop dient als een standaard waarde. In dit geval reageert het ook op de invoer-knop als het geen focus heeft

Enabled (Boolean)

het besturingselement kan worden geactiveerd

Tabstop (Boolean)

het besturingselement kan worden bereikt via de tabulator-toets [Tab]

TabIndex (Long)

positie van het besturingselement in de volgorde van activering

FontName (String)

naam van het lettertype

FontHeight (Single)

hoogte van het teken in punten (pt)

Tag (String)

tekenreeks die aanvullende informatie bevat, die kan worden opgeslagen in de knop voor programma-gecontroleerde toegang

TargetURL (String)

doel-URL voor knoppen van het type URL

TargetFrame (String)

naam van het venster (of frame) waarin de TargetURL moet worden geopend bij activering van de knop (voor knoppen van het type URL)

Label (String)

label voor de knop

TextColor (Long)

tekstkleur van het besturingselement

HelpText (String)

automatisch weergegeven tekst van de Help die wordt weergegeven als de muisaanwijzer boven het besturingselement is

HelpURL (String)

URL van de online Help voor het overeenkomende besturingselement

ButtonType (Enum)

actie die is gekoppeld aan de knop (standaard waarde uit com.sun.star.form.FormButtonType)

State (Short)

in schakelknop, 1 = ingedrukt, 0 = normaal

Via de eigenschap ButtonType heeft u de mogelijkheid om een actie te definiëren die wordt uitgevoerd als de knop wordt ingedrukt. De geassocieerde groep van constanten com.sun.star.form.FormButtonType verschaft de navolgende waarden:

PUSH

standaard knop

SUBMIT

einde van formulier invoer (speciaal van belang voor formulieren in HTML)

RESET

herstelt alle waarden binnen het formulier naar hun originele waarden

URL

aanroep van de URL gedefinieerd in TargetURL (wordt geopend binnen het venster dat was gespecificeerd via TargetFrame)

De typen knop OK en Annuleren, die beschikbaar zijn in dialoogvensters, worden niet ondersteund in formulieren.

Optieknoppen

De volgende eigenschappen van een Optieknop zijn beschikbaar via zijn model-object:

Enabled (Boolean)

het besturingselement kan worden geactiveerd

Tabstop (Boolean)

het besturingselement kan worden bereikt via de Tab-toets

TabIndex (Long)

positie van het besturingselement in de volgorde van activering

FontName (String)

naam van het lettertype

FontHeight (Single)

hoogte van het teken in punten (pt)

Tag (String)

tekenreeks die aanvullende informatie bevat, die kan worden opgeslagen in de knop voor programma-gecontroleerde toegang

Label (String)

opschrift voor de knop

Printable (Boolean)

het besturingselement kan worden afgedrukt

State (Short)

indien 1, is de optie geactiveerd, anders is die gedeactiveerd

RefValue (String)

tekenreeks voor opslaan van aanvullende informatie (bijvoorbeeld, voor het beheren van ID's van records met gegevens)

TextColor (Long)

tekstkleur van het besturingselement

HelpText (String)

automatisch weergegeven tekst van de Help die wordt weergegeven als de muisaanwijzer boven het besturingselement is

HelpURL (String)

URL van de online Help voor het overeenkomende besturingselement

Het mechanisme voor het groeperen van optieknoppen verschilt tussen de besturingselementen voor dialoogvensters en formulieren. Waar de besturingselementen die na elkaar verschijnen in dialoogvensters automatisch worden gecombineerd om een groep te vormen, wordt het groeperen in formulieren uitgevoerd op basis van de namen. Om dit te kunnen doen, moeten alle optieknoppen van een groep dezelfde naam bevatten. Apache OpenOffice combineert de gegroepeerde besturingselementen in een array zodat de individuele knoppen van een programma inApache OpenOffice BASIC op dezelfde manier kunnen worden bereikt.

Het volgende voorbeeld toont hoe door de modellen van de besturingselementen kan worden gegaan, waarbij de status van alle besturingselementen in een bepaalde groep als voorbeeld worden weergegeven:

Function test
  Dim oGroep as object
  Dim Doc As Object
  Dim Formulieren As Object
  Dim Formulier As Object
  Dim Ctl As Object
  Dim I as Integer
 
  Doc = ThisComponent
  Formulieren = Doc.Drawpage.Forms
 
  Formulier = Formulieren.GetbyIndex(0)
 
  oFormulier.getGroupByName("MijnOpties", oGroep)
  msg = ""
  for i = LBound(oGroep) to UBound(oGroep)
    oCtl = oGroep(i)
    msg = msg + oCtl.Name + ": " + (str(oCtl.State)) + chr(10)
  next i
  MsgBox msg 
 
end Function

De code komt overeen met het voorgaande voorbeeld voor het vaststellen van een eenvoudig besturingselement model. Het krijgt toegang tot de array met modellen via de methode GetGroupByName (in plaats van de methode GetByName om eenvoudige modellen te bepalen).

Keuzevakken

De volgende eigenschappen van een Keuzevak zijn beschikbaar via zijn model-object:

Enabled (Boolean)

het besturingselement kan worden geactiveerd

Tabstop (Boolean)

het besturingselement kan worden bereikt via de Tab-toets

TabIndex (Long)

positie van het besturingselement in de volgorde van activering

FontName (String)

naam van het lettertype

FontHeight (Single)

hoogte van het teken in punten (pt)

Tag (String)

tekenreeks die aanvullende informatie bevat, die kan worden opgeslagen in de knop voor programma-gecontroleerde toegang

Label (String)

opschrift voor de knop

Printable (Boolean)

het besturingselement kan worden afgedrukt

State (Short)

indien 1, is de optie geactiveerd, anders is die gedeactiveerd

RefValue (String)

tekenreeks voor opslaan van aanvullende informatie (bijvoorbeeld, voor het beheren van ID's van records met gegevens)

TextColor (Long)

tekstkleur van het besturingselement

HelpText (String)

automatisch weergegeven tekst van de Help die wordt weergegeven als de muisaanwijzer boven het besturingselement is

HelpURL (String)

URL van de online Help voor het overeenkomende besturingselement

Tekstvelden

De model-objecten van Keuzevakken bieden de volgende eigenschappen:

Align (short)

orientation of text (0: left-aligned, 1: centered, 2: right-aligned)

BackgroundColor (long)

background color of control element

Border (short)

type of border (0: no border, 1: 3D border, 2: simple border)

EchoChar (String)

echo character for password field

FontName (String)

name of font type

FontHeight (Single)

height of character in points (pt)

HardLineBreaks (Boolean)

the automatic line breaks are permanently inserted in the text of the control element

HScroll (Boolean)

the text has a horizontal scrollbar

MaxTextLen (Short)

maximum length of text; if 0 is specified, there are no limits

MultiLine (Boolean)

permits multi-line entries

Printable (Boolean)

the control element can be printed

ReadOnly (Boolean)

the content of the control element is read-only

Enabled (Boolean)

the control element can be activated

Tabstop (Boolean)

the control element can be reached through the tab key

TabIndex (Long)

position of the control element in the activation sequence

FontName (String)

name of font type

FontHeight (Single)

height of character in points (pt)

Text (String)

text of control element

TextColor (Long)

text color of control element

VScroll (Boolean)

the text has a vertical scrollbar

HelpText (String)

automatically displayed help text, which is displayed if the mouse cursor is above the control element

HelpURL (String)

URL of online help for the corresponding control element

List Boxes

The model object of the list box forms provides the following properties:

BackgroundColor (long)

background color of control element

Border (short)

type of border (0: no border, 1: 3D frame, 2: simple frame)

FontDescriptor (struct)

structure with details of font to be used (in accordance with com.sun.star.awt.FontDescriptor structure)

LineCount (Short)

number of lines of control element

MultiSelection (Boolean)

permits multiple selection of entries

SelectedItems (Array of Strings)

list of highlighted entries

StringItemList (Array of Strings)

list of all entries

ValueItemList (Array of Variant)

list containing additional information for each entry (for example, for administrating data record IDs)

Printable (Boolean)

the control element can be printed

ReadOnly (Boolean)

the content of the control element is read-only

Enabled (Boolean)

the control element can be activated

Tabstop (Boolean)

the control element can be reached through the tab key

TabIndex (Long)

position of control element in the activation sequence

FontName (String)

name of font type

FontHeight (Single)

height of character in points (pt)

Tag (String)

string containing additional information which can be saved in the button for program-controlled access

TextColor (Long)

text color of control element

HelpText (String)

automatically displayed help text, which is displayed if the mouse cursor is above the control element

HelpURL (String)

URL of online help for the corresponding control element

VBA : Through their ValueItemList property, list box forms provide a counterpart to the VBA property, ItemData, through which you can administer additional information for individual list entries.

Furthermore, the following methods are provided though the view object of the list box:

addItem (Item, Pos)

inserts the string specified in the Item at the Pos position in the list

addItems (ItemArray, Pos)

inserts the entries listed in the string's ItemArray data field in the list at the Pos position

removeItems (Pos, Count)

removes Count entries as of the Pos position

selectItem (Item, SelectMode)

activates or deactivates the highlighting for the element specified in the string Item depending on the SelectMode variable

makeVisible (Pos)

scrolls through the list field so that the entry specified by Pos is visible

Content on this page is licensed under the Public Documentation License (PDL).