Difference between revisions of "NL/Documentation/BASIC Guide/Working With Dialogs"

Revision as of 13:22, 17 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 >

Dialoogvensters van Apache OpenOffice BASIC bestaan uit een dialoogvenster dat velden, lijstvakken, radioknoppen en andere controle-elementen kan bevatten.

Dialoogvensters maken

U kunt dialoogvensters maken en structureren met behulp van de editor van Apache OpenOffice voor dialoogvensters:

Dialoogvensters maken en structureren in de editor voor dialoogvensters

U kunt de besturingselementen vanuit het ontwerp-palet (links) in het gebied van het dialoogvenster slepen, en hun positie en grootte definiëren.

Het voorbeeld toont een dialoogvenster dat een label en een keuzelijst bevat.

Een dialoogvenster dat een label en een keuzelijst bevat

U kunt een dialoogvenster openen met de volgende code:

Dim Dlg As Object
 
DialogLibraries.LoadLibrary("Standard")
Dlg = CreateUnoDialog(DialogLibraries.Standard.DlgDef)
Dlg.Execute()
Dlg.dispose()

CreateUnoDialog maakt een object genaamd Dlg dat verwijst naar het geassocieerde dialoogvenster. Vóórdat u een dialoogvenster kunt maken, moet u zich er van vergewissen dat de bibliotheek die het gebruikt (in dit voorbeeld de bibliotheek Standard) is geladen. Indien niet geladen, dan voert de methode LoadLibrary deze taak uit.

Als het dialoogvenster-object Dlg eenmaal is geïnitialiseerd, kunt u de methode Execute gebruiken om het dialoogvenster weer te geven. Dialoogvensters zoals deze worden omschreven als modal omdat zij geen andere actie van het programma toestaan totdat zij zijn gesloten. Zolang dit dialoogvenster geopend is, blijft het programma in de aanroep Execute.

De methode dispose aan het einde van de code geeft de bronnen, gebruikt door het dialoogvenster, vrij als het programma eenmaal eindigt.

Dialoogvensters sluiten

Sluiten met OK of Annuleren

Als een dialoogvenster een knop OK of Annulerenbevat, wordt het dialoogvenster automatisch gesloten als u op één van deze knoppen drukt. Meer informatie over de werking van deze knoppen wordt besproken in Besturingselementen voor dialoogvensters in detail.

Als u een dialoogvenster sluit met het klikken op de knop OK geeft de methode Execute een terugkeerwaarde van 1, anders wordt een waarde van 0 teruggegeven.

Dim Dlg As Object
 
DialogLibraries.LoadLibrary("Standard")
Dlg = CreateUnoDialog(DialogLibraries.Standard.MijnDialoogvenster)
Select Case Dlg.Execute() 
Case 1
  MsgBox "Op OK gedrukt"
Case 0 
  MsgBox "Op Annuleren gedrukt"
End Select

Sluiten met de knop Sluiten in de titelbalk

U kunt u een dialoogvenster sluiten door te klikken op de knop Sluiten in de titelbalk van het dialoogvenster. In dit geval geeft de methode Execute van het dialoogvenster de waarde 0 terug, hetzelfde als wanneer u op de knop Annuleren drukt.

Sluiten met een expliciete aanroep van het programma

Vanuit een routine die wordt aangeroepen bij een gebeurtenis van een besturingselement, bijv. drukken op een gewone knop, kunt u ook een geopend dialoogvenster sluiten met de methode endExecute:

Dlg.endExecute()

Het object dialoogvenster moet toegankelijk zijn vanuit de routine van d egebeurtenis. Een eenvoudige manier is om het te declareren als een variabele Private of Public gebruikelijk voor de routine voor het hoofd-dialoogvenster en de routine voor de gebeurtenis.

De methode execute van het dialoogvenster geeft de waarde 0 terug, wat dezelfde is als wanneer u op de knop Annuleren drukt.

De methode endDialog van het dialoogvenster is een verbetering van endExecute. Het argument er van specificeert de waarde die zal worden teruggegeven door de methode execute.

Dlg.endDialog(2)  ' Dlg.execute zal 2 teruggeven

Toegang tot individuele besturingselementen

A dialog can contain any number of control elements. You can access these elements through the getControl method that returns the control element by name.

Dim Ctl As Object
 
Ctl = Dlg.getControl("MyButton")
Ctl.Label = "New Label"

This code determines the object for the MyButton control element and then initializes the Ctl object variable with a reference to the element. Finally the code sets the Label property of the control element to the New Label value.

Template:Documentation/Note

Working With the Model of Dialogs and Control Elements

The division between visible program elements (View) and the data or documents behind them (Model) occurs at many places in Apache OpenOffice API. In addition to the methods and properties of control elements, both dialog and control element objects have a subordinate Model object. This object allows you to directly access the content of a dialog or control element.

In dialogs, the distinction between data and depiction is not always as clear as in other API areas of Apache OpenOffice. Elements of the API are available through both the View and the Model.

The Model property provides program-controlled access to the model of dialog and control element objects.

Dim cmdNext As Object
 
cmdNext = Dlg.getControl("cmdNext")
cmdNext.Model.Enabled = False

This example deactivates the cmdNext button in the Dlg dialog with the aid of the model object from cmdNext.