Eigenschappen

From Apache OpenOffice Wiki
Jump to: navigation, search
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 gelocaliseerd, bekijk het hoofdstuk van de Developer's Guide Localiseren van dialoogvensters.


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