Difference between revisions of "NL/Documentation/BASIC Guide/Message and Input Boxes (Runtime Library)"

From Apache OpenOffice Wiki
Jump to: navigation, search
 
Line 1: Line 1:
−
{{DISPLAYTITLE:Berichten en invoervakken ({{OOo}} Runtime-bibliotheek)}}
+
{{DISPLAYTITLE:Berichten en invoervakken ({{AOo}} Runtime-bibliotheek)}}
 
{{NL/Documentation/BASICGuideTOC/v2
 
{{NL/Documentation/BASICGuideTOC/v2
 
|ShowPrevNext=block
 
|ShowPrevNext=block
Line 8: Line 8:
 
}}
 
}}
 
   
 
   
−
{{OOo}} BASIC verschaft de functies <tt>MsgBox</tt> en <tt>InputBox</tt> als basis voor communicatie met de gebruiker.
+
{{AOo}} BASIC verschaft de functies <tt>MsgBox</tt> en <tt>InputBox</tt> als basis voor communicatie met de gebruiker.
  
 
== Berichten weergeven ==
 
== Berichten weergeven ==
 
<tt>MsgBox</tt> toont een basisvenster met informatie, dat één of meer knoppen kan hebben. In zijn eenvoudigste variant bevat de <tt>MsgBox</tt> slechts tekst en een knop OK:
 
<tt>MsgBox</tt> toont een basisvenster met informatie, dat één of meer knoppen kan hebben. In zijn eenvoudigste variant bevat de <tt>MsgBox</tt> slechts tekst en een knop OK:
  
−
<source lang="oobas">
+
<syntaxhighlight lang="oobas">
 
MsgBox "Dit is een stukje informatie!"
 
MsgBox "Dit is een stukje informatie!"
−
</source>
+
</syntaxhighlight>
  
 
Het uiterlijk van het venster met informatie kan worden gewijzigd met behulp van een parameter. De parameter verschaft de opties om aanvullende knoppen toe te voegen, de vooraf toegewezen knop te definiëren en een informatie-symbool toe te voegen. De waarden om de knoppen te selecteren zijn:
 
Het uiterlijk van het venster met informatie kan worden gewijzigd met behulp van een parameter. De parameter verschaft de opties om aanvullende knoppen toe te voegen, de vooraf toegewezen knop te definiëren en een informatie-symbool toe te voegen. De waarden om de knoppen te selecteren zijn:
Line 45: Line 45:
 
De volgende aanroep geeft een venster met informatie weer met de knoppen Ja en Nee (waarde 4), waarvan de tweede knop (Nee) is ingesteld als de standaard waarde (waarde 256) en waarin ook een vraagteken staat (waarde 32), 4+256+32=292.
 
De volgende aanroep geeft een venster met informatie weer met de knoppen Ja en Nee (waarde 4), waarvan de tweede knop (Nee) is ingesteld als de standaard waarde (waarde 256) en waarin ook een vraagteken staat (waarde 32), 4+256+32=292.
  
−
<source lang="oobas">
+
<syntaxhighlight lang="oobas">
 
MsgBox "Wilt u doorgaan?",  292
 
MsgBox "Wilt u doorgaan?",  292
 
' of,
 
' of,
 
MsgBox "Wilt u doorgaan?", MB_YESNO + MB_DEFBUTTON2 + MB_ICONQUESTION
 
MsgBox "Wilt u doorgaan?", MB_YESNO + MB_DEFBUTTON2 + MB_ICONQUESTION
−
</source>
+
</syntaxhighlight>
 
[[Image:MsgBox292_nl.png|300px|none|thumb|Weergave van het venster met informatie]]
 
[[Image:MsgBox292_nl.png|300px|none|thumb|Weergave van het venster met informatie]]
  
Line 64: Line 64:
 
In het vorige voorbeeld zou het controleren van de teruggegeven waarden als volgt kunnen:  
 
In het vorige voorbeeld zou het controleren van de teruggegeven waarden als volgt kunnen:  
  
−
<source lang="oobas">
+
<syntaxhighlight lang="oobas">
 
Dim iVak as Integer
 
Dim iVak as Integer
 
iVak = MB_YESNO + MB_DEFBUTTON2 + MB_ICONQUESTION
 
iVak = MB_YESNO + MB_DEFBUTTON2 + MB_ICONQUESTION
Line 74: Line 74:
 
   ' knop Nee ingedrukt
 
   ' knop Nee ingedrukt
 
End IF
 
End IF
−
</source>
+
</syntaxhighlight>
  
 
In aanvulling op de informatietekst en de parameter voor het opmaken van het informatievenster, kan <tt>MsgBox</tt> ook een derde parameter toestaan, die de tekst voor de titel van het venster definieert:
 
In aanvulling op de informatietekst en de parameter voor het opmaken van het informatievenster, kan <tt>MsgBox</tt> ook een derde parameter toestaan, die de tekst voor de titel van het venster definieert:
  
−
<source lang="oobas">
+
<syntaxhighlight lang="oobas">
 
MsgBox "Wilt u doorgaan?",  292, "Titel vak"
 
MsgBox "Wilt u doorgaan?",  292, "Titel vak"
−
</source>
+
</syntaxhighlight>
  
 
Indien er geen titel voor het vak wordt gespecificeerd, is de standaard “soffice”.
 
Indien er geen titel voor het vak wordt gespecificeerd, is de standaard “soffice”.
Line 92: Line 92:
 
* Een standaardwaarde die kan worden toegevoegd aan het invoergebied.
 
* Een standaardwaarde die kan worden toegevoegd aan het invoergebied.
  
−
<source lang="oobas">
+
<syntaxhighlight lang="oobas">
 
InvoerWaarde = InputBox("Voer alstublieft een waarde in:", "Test", "standaardwaarde")
 
InvoerWaarde = InputBox("Voer alstublieft een waarde in:", "Test", "standaardwaarde")
−
</source>
+
</syntaxhighlight>
 
[[Image:InputBoxTest_nl.png|600px|none|thumb|Weergave van het invoervak]]
 
[[Image:InputBoxTest_nl.png|600px|none|thumb|Weergave van het invoervak]]
  

Latest revision as of 15:29, 9 February 2021

Book.png

Apache OpenOffice BASIC verschaft de functies MsgBox en InputBox als basis voor communicatie met de gebruiker.

Berichten weergeven

MsgBox toont een basisvenster met informatie, dat één of meer knoppen kan hebben. In zijn eenvoudigste variant bevat de MsgBox slechts tekst en een knop OK: 

MsgBox "Dit is een stukje informatie!"

Het uiterlijk van het venster met informatie kan worden gewijzigd met behulp van een parameter. De parameter verschaft de opties om aanvullende knoppen toe te voegen, de vooraf toegewezen knop te definiëren en een informatie-symbool toe te voegen. De waarden om de knoppen te selecteren zijn:

Documentation note.png Met de conventie dat de symbolische namen, die hieronder worden gegeven, worden geschreven in HOOFDLETTERS om aan te geven dat zij vooraf gedefinieerd zijn, in plaats van gebruikergedefinieerd. De namen zijn echter niet hoofdletter-gevoelig.

De waarden voor het selecteren van de knoppen zijn:

  • 0, MB_OK - knop OK
  • 1, MB_OKCANCEL - knoppen OK en Annuleren
  • 2, MB_ABORTRETRYIGNORE - knoppen Afbreken, Opnieuw proberen en Negeren
  • 3, MB_YESNOCANCEL - knoppen Ja, Nee en Annuleren
  • 4, MB_YESNO - knoppen Ja en Nee
  • 5, MB_RETRYCANCEL - knoppen Opnieuw proberen en Annuleren

Tel één van de volgende waarden bij de waarde van de parameter uit de lijst van selecties voor de knoppen op om een knop als standaardknop in te stellen. Bijvoorbeeld: om de knoppen Ja, Nee en Annuleren (waarde 3) te maken, waarbij Annuleren de standaard (waarde 512) is, is de parameterwaarde 3 + 512 = 515. De uitdrukking MB_YESNOCANCEL + MB_DEFBUTTON3 is moeilijker te schrijven, maar makkelijker te begrijpen.

  • 0, MB_DEFBUTTON1 - Eerste knop is de standaardwaarde
  • 256, MB_DEFBUTTON2 - Tweede knop is de standaardwaarde
  • 512, MB_DEFBUTTON3 - Derde knop is de standaardwaarde

Tenslotte zijn de volgende symbolen voor informatie beschikbaar en kunnen ook worden weergegeven door de waarde op te tellen bij de relevante waarden voor de parameters:


  • 16, MB_ICONSTOP - Stopteken
  • 32, MB_ICONQUESTION - Vraagteken
  • 48, MB_ICONEXCLAMATION - Uitroepteken
  • 64, MB_ICONINFORMATION - pictogram Tip

De volgende aanroep geeft een venster met informatie weer met de knoppen Ja en Nee (waarde 4), waarvan de tweede knop (Nee) is ingesteld als de standaard waarde (waarde 256) en waarin ook een vraagteken staat (waarde 32), 4+256+32=292. 

MsgBox "Wilt u doorgaan?",  292
' of,
MsgBox "Wilt u doorgaan?", MB_YESNO + MB_DEFBUTTON2 + MB_ICONQUESTION
Weergave van het venster met informatie

Als een venster met informatie meerdere knoppen bevat, dan zou een terugkeerwaarde moeten worden bevraagd om te bepalen welke knop ingedrukt werd. De volgende terugkeerwaarden zijn in dit geval beschikbaar:

  • 1, IDOK - OK
  • 2, IDCANCEL - Annuleren
  • 3, IDABORT - Afbreken
  • 4, IDRETRY - Opnieuw proberen
  • 5, IDIGNORE - Negeren
  • 6, IDYES - Ja
  • 7, IDNO - Nee

In het vorige voorbeeld zou het controleren van de teruggegeven waarden als volgt kunnen: 

Dim iVak as Integer
iVak = MB_YESNO + MB_DEFBUTTON2 + MB_ICONQUESTION
If MsgBox ("Wilt u doorgaan?", iVak) = IDYES Then
' of,
If MsgBox ("Wilt u doorgaan?",  292) = 6 Then
  ' knop Ja ingedrukt
Else
  ' knop Nee ingedrukt
End IF

In aanvulling op de informatietekst en de parameter voor het opmaken van het informatievenster, kan MsgBox ook een derde parameter toestaan, die de tekst voor de titel van het venster definieert: 

MsgBox "Wilt u doorgaan?",  292, "Titel vak"

Indien er geen titel voor het vak wordt gespecificeerd, is de standaard “soffice”.

Invoervak voor het bevragen van eenvoudige tekenreeksen

De functie InputBox vraagt eenvoudige tekenreeksen van de gebruiker. Het is daarom een eenvoudig alternatief om dialoogvensters te configureren. InputBox kan drie standaard parameters ontvangen:

  • Een informatieve tekst.
  • Een titel voor het vak.
  • Een standaardwaarde die kan worden toegevoegd aan het invoergebied. 
InvoerWaarde = InputBox("Voer alstublieft een waarde in:", "Test", "standaardwaarde")
Weergave van het invoervak
  • De dimensies van het venster InputBox kunnen niet worden gewijzigd.
  • Als de gebruiker op de knop OK klikt, geeft de InputBox de tekenreeks terug die getypt is door de gebruiker (of de standaard tekenreeks als die niet werd gewijzigd).
  • Als de gebruiker op de knop Annuleren drukt of het venster sluit, geeft de InputBox een lege tekenreeks terug.


Content on this page is licensed under the Public Documentation License (PDL).
Retrieved from "https://wiki.openoffice.org/w/index.php?title=NL/Documentation/BASIC_Guide/Message_and_Input_Boxes_(Runtime_Library)&oldid=247821"
Personal tools