Eigenschappen en methoden (API)

From Apache OpenOffice Wiki
Jump to: navigation, search
Book.png

Een object in Apache OpenOffice BASIC verschaft een scala aan eigenschappen en methoden die kunnen worden aangeroepen door middel van het object.

Eigenschappen

Eigenschappen zijn als de eigenschappen van een object; bijvoorbeeld: Filename en Title voor een object Document.

De eigenschappen worden ingesteld door middel van een eenvoudige toewijzing:

Document.Title = "OpenOffice.org BASIC Programmeursgids"
Document.Filename = "basgids.odt"

Een eigenschap, net zoals een variabele, heeft een type dat definieert welke waarde het kan opnemen. De vorengenoemde eigenschappen Filename en Title zijn van het type tekenreeks (String).


Echte eigenschappen en geïmiteerde eigenschappen

De meeste van de eigenschappen van een object in Apache OpenOffice BASIC zijn als zodanig gedefinieerd in de beschrijving van de service in UNO. In aanvulling op deze "echte" eigenschappen, zijn er ook eigenschappen in Apache OpenOffice BASIC die bestaan uit twee methoden op het niveau van UNO. Eén van deze wordt gebruikt om de waarde van de eigenschap te bevragen en de andere wordt gebruikt om die in te stellen (methoden get en set). De eigenschap wordt virtueel geïmiteerd vanuit deze twee methoden. Bijvoorbeeld: objecten van tekens in UNO verschaffen de methoden getPosition en setPosition waardoor het geassocieerde sleutelpunt kan worden aangeroepen en gewijzigd. De programmeur van Apache OpenOffice BASIC kan de waarden benaderen via de eigenschap Position. Los hiervan zijn de originele methoden ook beschikbaar (in ons voorbeeld: getPosition en setPosition).

Methoden

Methoden moeten worden gezien als functies die direct relateren tot een object en waardoor dit object wordt aangeroepen. Het voorgaande object Document zou bijvoorbeeld een methode Save kunnen verschaffen, die als volgt kan worden aangeroepen:

Document.Save()

Methoden, net als functies, mogen parameters en terugkeerwaarden bevatten. De syntaxis van dergelijke aanroepen voor methoden is georiënteerd op de klassieke functies. De volgende aanroep specificeert ook de parameter True voor het object Document bij het bevragen van de methode Save.

OK = Document.Save(True)

Als deze methode is voltooid, geeft Save een terugkeerwaarde weer in de variabele OK.


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