Eigenschappen
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.
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.
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:
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). |