Difference between revisions of "NL/Documentation/BASIC Guide/Properties"

From Apache OpenOffice Wiki
Jump to: navigation, search
(Created page with "{{NL/Documentation/BASICGuideTOC/v2 |ShowPrevNext=block |ShowPrevPage=block |PrevPage=NL/Documentation/BASIC Guide/Working With Dialogs |NextPage=NL/Documentation/BASIC Guide/..." (tussenstap opslaan))
 
m
 
(7 intermediate revisions by 2 users not shown)
Line 18: Line 18:
 
;<tt>Model.Title (String)</tt>:titel dialoogvenster (alleen van toepassing in dialoogvensters)
 
;<tt>Model.Title (String)</tt>:titel dialoogvenster (alleen van toepassing in dialoogvensters)
  
−
== Position and Size ==
+
== Positie en grootte ==
  
−
You can query the size and position of a control element using the following properties of the model object:
+
U kunt de grootte en positie van een besturingselement navragen met behulp van de volgende eigenschappen van het modelobject:
  
−
;<tt>Model.Height (long)</tt>:height of control element (in ma units)
+
;<tt>Model.Height (long)</tt>:hoogte van besturingselement (in eenheden ma)
−
;<tt>Model.Width (long)</tt>:width of control element (in ma units)
+
;<tt>Model.Width (long)</tt>:breedte van besturingselement (in eenheden ma)
−
;<tt>Model.PositionX (long)</tt>:X-position of control element, measured from the left inner edge of the dialog (in ma units)
+
;<tt>Model.PositionX (long)</tt>:positie X van besturingselement, gemeten vanuit de binnenzijde van de linker rand van het dialoogvenster (in eenheden ma)
−
;<tt>Model.PositionY (long)</tt>:Y-position of control element, measured from top inner edge of the dialog (in ma units)
+
;<tt>Model.PositionY (long)</tt>:positie Y van besturingselement, gemeten vanuit de binnenzijde van de bovenzijde van het dialoogvenster (in eenheden ma)
  
−
To ensure platform independence for the appearance of dialogs, {{OOo}} uses the '''Map AppFont (ma)''' internal unit to specify the position and size within dialogs. An ma unit is defined as being one eighth of the average height of a character from the system font defined in the operating system and one quarter of its width. By using ma units, {{OOo}} ensures that a dialog looks the same on different systems under different system settings.
+
{{OOo}} gebruikt de interne eenheid '''Map AppFont (ma)''' om de positie en grootte binnen dialoogvensters te specificeren om platform-onafhankelijkheid voor het uiterlijk van dialoogvensters te verzekeren. Een eenheid ma wordt gedefinieerd als een achtste van de gemiddelde hoogte van een teken uit het systeem-lettertype, gedefinieerd in het besturingssysteem en een kwart van diens breedte. Door eenheden ma te gebruiken verzekert {{AOo}} dat een dialoogvenster er hetzelfde uitziet op verschillende systemen met verschillende systeem-instellingen.
  
−
If you want to change the size or position of control elements for runtime, determine the total size of the dialog and adjust the values for the control elements to the corresponding part ratios.
+
Als u de grootte of positie van besturingselementen voor runtime wilt wijzigen, bepaald dan de totale grootte van het dialoogvenster en pas de waarden voor de besturingselementen naar ratio aan voor de corresponderende delen.
  
−
{{Documentation/Note|The Map AppFont (ma) replaces the Twips unit to achieve better platform independence.}}
+
{{Note|De Map AppFont (ma) vervangt de eenheid TWIPS om betere platform-onafhankelijkheid te bereiken.}}
  
−
== Focus and Tabulator Sequence ==
+
== Focus en volgorde van tabulator ==
  
−
You can navigate through the control elements in any dialog by pressing the Tab key. The following properties are available in this context in the control elements model:
+
U kunt  door de besturingselementen in elk dialoogvenster navigeren door te drukken op de Tab-toets. De volgende eigenschappen zijn in deze context beschikbaar in het besturingselementen model:
  
−
;<tt>Model.Enabled (Boolean)</tt>:activates the control element
+
;<tt>Model.Enabled (Boolean)</tt>:activeert het besturingselement
−
;<tt>Model.Tabstop (Boolean)</tt>:allows the control element to be reached through the Tab key
+
;<tt>Model.Tabstop (Boolean)</tt>:staat toe dat het besturingselement wordt bereikt via de Tab-toets
−
;<tt>Model.TabIndex (Long)</tt>:position of control element in the order of activation
+
;<tt>Model.TabIndex (Long)</tt>:positie van het besturingselement in de volgorde van activeren
  
−
Finally, the control element provides a <tt>setFocus</tt> method that ensures that the underlying control element receives the focus:
+
Tenslotte verschaft het besturingselement een  methode <tt>setFocus</tt> die er voor zorgt dat het onderliggende besturingselement de focus ontvangt:
  
−
;<tt>setFocus</tt>:control element receives the focus (only for dialogs)
+
;<tt>setFocus</tt>:besturingselement ontvangt de focus (alleen voor dialoogvensters)
  
−
== Multi-Page Dialogs ==
+
== Dialoogvenster met meerdere pagina's ==
  
−
A dialog in {{OOo}} can have more than one tab page. The <tt>Step</tt> property of a dialog defines the current tab page of the dialog whereas the <tt>Step</tt> property for a control element specifies the tab page where the control element is to be displayed.
+
Een dialoogvenster in {{AOo}} kan meer dan één tabpagina hebben. De eigenschap <tt>Step</tt> van een dialoogvenster definieert de huidige tabpagina van het dialoogvenster, waarbij de eigenschap <tt>Step</tt> voor een besturingselement de tabpagina specificeert waarop het besturingselement moet worden weergegeven.
  
−
The <tt>Step</tt>-value of 0 is a special case. If you set this value to zero in a dialog, all of the control elements are visible regardless of their <tt>Step</tt> value. Similarly, if you set this value to zero for a control element, the element is displayed on all of the tab pages in a dialog.
+
De waarde van 0 voor <tt>Step</tt> is een speciaal geval. Als u deze waarde instelt op nul in een dialoogvenster, zijn alle besturingselementen zichtbaar, ongeacht hun waarde voor <tt>Step</tt>. Eveneens wordt, als u deze waarde voor een besturingselement instelt op nul, het element weergegeven op alle tabpagina's in een dialoogvenster.
  
−
[[Image:documentation_basicguide_dlg_03.gif|none|thumb|500px|Designing Page 1 of the dialog]]
+
[[Image:documentation_basicguide_dlg_03_nl.png|none|thumb|500px|Ontwerp van pagina 1 van het dialoogvenster]]
  
−
In the preceding example, you can also assign the <tt>Step</tt> value of 0 to the dividing line as well as the <tt>Cancel</tt>, <tt>Prev</tt>, <tt>Next</tt>, and <tt>Done</tt> buttons to display these elements on all pages. You can also assign the elements to an individual tab page (for example page 1).
+
In het voorgaande voorbeeld kunt u ook de waarde 0 aan <tt>Step</tt> toewijzen aan de scheidingslijn (horizontale / verticale lijn) en ook aan de knoppen <tt>Annuleren</tt>, <tt>Vorige</tt>, <tt>Volgende</tt> en <tt>Voltooien</tt> om deze elementen op alle pagina's weer te geven. U kunt ook de elementen toewijzen aan een individuele tabpagina (bijvoorbeeld pagina 1).
  
−
The following program code shows how the <tt>Step</tt> value in event handlers of the <tt>Next</tt> and <tt>Prev</tt> buttons can be increased or reduced and changes the status of the buttons.
+
De volgende programmacode toont u hoe de waarde <tt>Step</tt> in gebeurtenisbehandelaars van de knoppen <tt>Volgende</tt> en <tt>Vorige</tt> kan worden vergroot of verkleind en de status van de knoppen wijzigt.
  
−
<source lang="oobas">
+
<syntaxhighlight lang="oobas">
−
Sub cmdNext_Initiated
+
Sub cmdVolgende_Initiated
  
−
   Dim cmdNext As Object
+
   Dim cmdVolgende As Object
−
   Dim cmdPrev As Object
+
   Dim cmdVorige As Object
  
−
   cmdPrev = Dlg.getControl("cmdPrev")
+
   cmdVorige = Dlg.getControl("cmdVorige")
−
   cmdNext = Dlg.getControl("cmdNext")
+
   cmdVolgende = Dlg.getControl("cmdVolgende")
−
   cmdPrev.Model.Enabled = Not cmdPrev.Model.Enabled
+
   cmdVorige.Model.Enabled = Not cmdVorige.Model.Enabled
−
   cmdNext.Model.Enabled = False
+
   cmdVolgende.Model.Enabled = False
 
   Dlg.Model.Step = Dlg.Model.Step + 1
 
   Dlg.Model.Step = Dlg.Model.Step + 1
  
 
End Sub
 
End Sub
  
−
Sub cmdPrev_Initiated
+
Sub cmdVorige_Initiated
  
−
   Dim cmdNext As Object
+
   Dim cmdVolgende As Object
−
   Dim cmdPrev As Object
+
   Dim cmdVorige As Object
  
−
   cmdPrev = Dlg.getControl("cmdPrev")
+
   cmdVorige = Dlg.getControl("cmdVorige")
−
   cmdNext = Dlg.getControl("cmdNext")
+
   cmdVolgende = Dlg.getControl("cmdVolgende")
−
   cmdPrev.Model.Enabled = False
+
   cmdVorige.Model.Enabled = False
−
   cmdNext.Model.Enabled = True
+
   cmdVolgende.Model.Enabled = True
 
   Dlg.Model.Step = Dlg.Model.Step - 1
 
   Dlg.Model.Step = Dlg.Model.Step - 1
  
 
End Sub
 
End Sub
−
</source>
+
</syntaxhighlight>
  
−
A global <tt>Dlg</tt> variable that references an open dialog must be included to make this example possible. The dialog then changes its appearance as follows:
+
Een globale variabele <tt>Dlg</tt> die verwijst naar een geopend dialoogvenster moet worden opgenomen om dit voorbeeld mogelijk te maken. Het dialoogvenster wijzigt zijn verschijningsvorm dan als volgt:
  
−
[[Image:documentation_basicguide_dlg_05.gif|none|thumb|400px|Page 1]]
+
[[Image:documentation_basicguide_dlg_05_nl.png|none|thumb|400px|Pagina 1]]
  
−
[[Image:documentation_basicguide_dlg_06.gif|none|thumb|400px|Page 2]]
+
[[Image:documentation_basicguide_dlg_06_nl.png|none|thumb|400px|Pagina 2]]
−
{{Documentation/Tip|You can find an [[Going_further_with_Dialog_and_Component#Multi-Page_Dialog|other OOoBasic example here]].}}
+
{{Tip|U kunt een [[Going_further_with_Dialog_and_Component#Multi-Page_Dialog|ander voorbeeld voor {{AOo}} BASIC hier vinden]].}}
  
 +
== Dialoogvensters ondersteunen verschillende talen ==
  
−
== Dialogs supporting several languages ==
+
De tekenreeksen van een dialoogvenster kunnen worden gelokaliseerd, bekijk het hoofdstuk van de Developer's Guide [[Documentation/DevGuide/Basic/Dialog_Localization|Localiseren van dialoogvensters]].
−
 
+
−
The strings of a Dialog can be localized, see the Developer's Guide chapter [[Documentation/DevGuide/Basic/Dialog_Localization|Dialog Localization]].
+
−
 
+
  
 
{{InterWiki Languages BasicGuide|articletitle=Documentation/BASIC Guide/Properties}}
 
{{InterWiki Languages BasicGuide|articletitle=Documentation/BASIC Guide/Properties}}
 
{{PDL1}}
 
{{PDL1}}

Latest revision as of 09:02, 27 August 2022

Book.png


Naam en titel

Elk besturingselement heeft zijn eigen naam die kan worden bevraagd met behulp van de volgende eigenschap van Model:

Model.Name (String)
naam besturingselement

U kunt de titel specificeren die in de titelbalk van een dialoogvenster verschijnt met de volgende eigenschap van het model:

Model.Title (String)
titel dialoogvenster (alleen van toepassing in dialoogvensters)

Positie en grootte

U kunt de grootte en positie van een besturingselement navragen met behulp van de volgende eigenschappen van het modelobject:

Model.Height (long)
hoogte van besturingselement (in eenheden ma)
Model.Width (long)
breedte van besturingselement (in eenheden ma)
Model.PositionX (long)
positie X van besturingselement, gemeten vanuit de binnenzijde van de linker rand van het dialoogvenster (in eenheden ma)
Model.PositionY (long)
positie Y van besturingselement, gemeten vanuit de binnenzijde van de bovenzijde van het dialoogvenster (in eenheden ma)

Apache OpenOffice gebruikt de interne eenheid Map AppFont (ma) om de positie en grootte binnen dialoogvensters te specificeren om platform-onafhankelijkheid voor het uiterlijk van dialoogvensters te verzekeren. Een eenheid ma wordt gedefinieerd als een achtste van de gemiddelde hoogte van een teken uit het systeem-lettertype, gedefinieerd in het besturingssysteem en een kwart van diens breedte. Door eenheden ma te gebruiken verzekert Apache OpenOffice dat een dialoogvenster er hetzelfde uitziet op verschillende systemen met verschillende systeem-instellingen.

Als u de grootte of positie van besturingselementen voor runtime wilt wijzigen, bepaald dan de totale grootte van het dialoogvenster en pas de waarden voor de besturingselementen naar ratio aan voor de corresponderende delen.

Documentation note.png De Map AppFont (ma) vervangt de eenheid TWIPS om betere platform-onafhankelijkheid te bereiken.

Focus en volgorde van tabulator

U kunt door de besturingselementen in elk dialoogvenster navigeren door te drukken op de Tab-toets. De volgende eigenschappen zijn in deze context beschikbaar in het besturingselementen model:

Model.Enabled (Boolean)
activeert het besturingselement
Model.Tabstop (Boolean)
staat toe dat het besturingselement wordt bereikt via de Tab-toets
Model.TabIndex (Long)
positie van het besturingselement in de volgorde van activeren

Tenslotte verschaft het besturingselement een methode setFocus die er voor zorgt dat het onderliggende besturingselement de focus ontvangt:

setFocus
besturingselement ontvangt de focus (alleen voor dialoogvensters)

Dialoogvenster met meerdere pagina's

Een dialoogvenster in Apache OpenOffice kan meer dan één tabpagina hebben. De eigenschap Step van een dialoogvenster definieert de huidige tabpagina van het dialoogvenster, waarbij de eigenschap Step voor een besturingselement de tabpagina specificeert waarop het besturingselement moet worden weergegeven.

De waarde van 0 voor Step is een speciaal geval. Als u deze waarde instelt op nul in een dialoogvenster, zijn alle besturingselementen zichtbaar, ongeacht hun waarde voor Step. Eveneens wordt, als u deze waarde voor een besturingselement instelt op nul, het element weergegeven op alle tabpagina's in een dialoogvenster.

Ontwerp van pagina 1 van het dialoogvenster

In het voorgaande voorbeeld kunt u ook de waarde 0 aan Step toewijzen aan de scheidingslijn (horizontale / verticale lijn) en ook aan de knoppen Annuleren, Vorige, Volgende en Voltooien om deze elementen op alle pagina's weer te geven. U kunt ook de elementen toewijzen aan een individuele tabpagina (bijvoorbeeld pagina 1).

De volgende programmacode toont u hoe de waarde Step in gebeurtenisbehandelaars van de knoppen Volgende en Vorige kan worden vergroot of verkleind en de status van de knoppen wijzigt. 

Sub cmdVolgende_Initiated
 
   Dim cmdVolgende As Object
   Dim cmdVorige As Object
 
   cmdVorige = Dlg.getControl("cmdVorige")
   cmdVolgende = Dlg.getControl("cmdVolgende")
   cmdVorige.Model.Enabled = Not cmdVorige.Model.Enabled
   cmdVolgende.Model.Enabled = False
   Dlg.Model.Step = Dlg.Model.Step + 1
 
End Sub
 
Sub cmdVorige_Initiated
 
   Dim cmdVolgende As Object
   Dim cmdVorige As Object
 
   cmdVorige = Dlg.getControl("cmdVorige")
   cmdVolgende = Dlg.getControl("cmdVolgende")
   cmdVorige.Model.Enabled = False
   cmdVolgende.Model.Enabled = True
   Dlg.Model.Step = Dlg.Model.Step - 1
 
End Sub

Een globale variabele Dlg die verwijst naar een geopend dialoogvenster moet worden opgenomen om dit voorbeeld mogelijk te maken. Het dialoogvenster wijzigt zijn verschijningsvorm dan als volgt:

Pagina 1
Pagina 2


Dialoogvensters ondersteunen verschillende talen

De tekenreeksen van een dialoogvenster kunnen worden gelokaliseerd, bekijk het hoofdstuk van de Developer's Guide Localiseren van dialoogvensters.


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/Properties&oldid=250470"
Personal tools