Difference between revisions of "NL/Documentation/BASIC Guide/UNO Tools"
m (→Gereedschap om te debuggen) |
|||
Line 14: | Line 14: | ||
Een aantal objecten in UNO ondersteunt de methode <tt>supportsService</tt>, waarmee u vast kunt stellen of een object een bepaalde service ondersteunt. De volgende aanroep bijvoorbeeld bepaalt of het object <tt>TekstElement</tt> de service <idl>com.sun.star.text.Paragraph</idl> ondersteunt. | Een aantal objecten in UNO ondersteunt de methode <tt>supportsService</tt>, waarmee u vast kunt stellen of een object een bepaalde service ondersteunt. De volgende aanroep bijvoorbeeld bepaalt of het object <tt>TekstElement</tt> de service <idl>com.sun.star.text.Paragraph</idl> ondersteunt. | ||
− | < | + | <syntaxhighlight lang="oobas"> |
OK = TekstElement.supportsService("com.sun.star.text.Paragraph") | OK = TekstElement.supportsService("com.sun.star.text.Paragraph") | ||
− | </ | + | </syntaxhighlight> |
== Eigenschappen debuggen == | == Eigenschappen debuggen == | ||
Line 28: | Line 28: | ||
De volgende programmacode toont hoe <tt>DBG_properties</tt> en <tt>DBG_methods</tt> kunnen worden gebruikt in echte toepassingen. Het creëert eerst de service <idl>com.sun.star.frame.Desktop</idl> en geeft dan de ondersteunde eigenschappen en methoden weer in berichtenvensters. | De volgende programmacode toont hoe <tt>DBG_properties</tt> en <tt>DBG_methods</tt> kunnen worden gebruikt in echte toepassingen. Het creëert eerst de service <idl>com.sun.star.frame.Desktop</idl> en geeft dan de ondersteunde eigenschappen en methoden weer in berichtenvensters. | ||
− | < | + | <syntaxhighlight lang="oobas"> |
Dim Obj As Object | Dim Obj As Object | ||
Obj = createUnoService("com.sun.star.frame.Desktop") | Obj = createUnoService("com.sun.star.frame.Desktop") | ||
Line 34: | Line 34: | ||
MsgBox Obj.DBG_Properties | MsgBox Obj.DBG_Properties | ||
MsgBox Obj.DBG_methods | MsgBox Obj.DBG_methods | ||
− | </ | + | </syntaxhighlight> |
Wees er attent op dat bij het gebruik van <tt>DBG_properties</tt> de functie alle eigenschappen die een bepaalde service theoretisch kan ondersteunen weergeeft. Er is echter geen garantie dat deze ook kunnen worden gebruikt door het gevraagde object. In hele zeldzame gevallen moet u dus, vóór het opvragen van een eigenschap, eerst de functie <tt>IsEmpty</tt> gebruiken om te controleren of de eigenschap wel echt beschikbaar is. | Wees er attent op dat bij het gebruik van <tt>DBG_properties</tt> de functie alle eigenschappen die een bepaalde service theoretisch kan ondersteunen weergeeft. Er is echter geen garantie dat deze ook kunnen worden gebruikt door het gevraagde object. In hele zeldzame gevallen moet u dus, vóór het opvragen van een eigenschap, eerst de functie <tt>IsEmpty</tt> gebruiken om te controleren of de eigenschap wel echt beschikbaar is. | ||
Line 44: | Line 44: | ||
Het venster Controle van de BASIC IDE kan de eigenschappen van een object van UNO weergeven (maar niet de methoden en niet de interfaces). | Het venster Controle van de BASIC IDE kan de eigenschappen van een object van UNO weergeven (maar niet de methoden en niet de interfaces). | ||
− | Gebruik in plaats daarvan <b>[[Extensions_development_basic#Xray_tool|programma Xray]] of [ | + | Gebruik in plaats daarvan <b>[[Extensions_development_basic#Xray_tool|programma Xray]] of [https://extensions.openoffice.org/project/MRI programma MRI]</b> om alle beschikbare informatie van een object weer te geven en te koppelen aan de overeenkomende documentatie van de API. |
− | {{Documentation/VBAnote|{{ | + | {{Documentation/VBAnote|{{AOo}} BASIC heeft '''geen''' aanvulling van code. Alleen tijdens runtime kunt u vaststellen welke eigenschappen of methoden beschikbaar zijn voor een object. Alle bovengenoemde programma's voor debuggen werken bij een programma dat wordt uitgevoerd. }} |
== Verwijzingen naar de API == | == Verwijzingen naar de API == | ||
− | Meer informatie over de beschikbare services en hun interfaces, | + | Meer informatie over de beschikbare services en hun interfaces, methoden en eigenschappen kan worden gevonden in de [https://www.openoffice.org/api/docs/common/ref/com/sun/star/module-ix.html verwijzingen voor de {{AOo}} API]. |
{{InterWiki Languages BasicGuide|articletitle=Documentation/BASIC Guide/UNO Tools}} | {{InterWiki Languages BasicGuide|articletitle=Documentation/BASIC Guide/UNO Tools}} | ||
{{PDL1}} | {{PDL1}} |
Latest revision as of 16:12, 9 February 2021
- Universal Network Objects (UNO)
- Eigenschappen en methoden
- Modules, services en interfaces
- Gereedschap voor werken met UNO
- Overzicht van centrale interfaces
De vraag blijft bestaan, welke objecten – of services als we blijven in de terminologie van UNO – ondersteunen welke eigenschappen, methoden en interfaces en hoe kunnen deze worden bepaald. In aanvulling op deze gids, kunt u meer informatie over objecten vinden in de volgende bronnen: de methode supportsService, de methoden voor debuggen en ook in de Developer's Guide en de verwijzingen naar de API.
Contents
De methode supportsService
Een aantal objecten in UNO ondersteunt de methode supportsService, waarmee u vast kunt stellen of een object een bepaalde service ondersteunt. De volgende aanroep bijvoorbeeld bepaalt of het object TekstElement de service com.sun.star.text.Paragraph ondersteunt.
OK = TekstElement.supportsService("com.sun.star.text.Paragraph")
Eigenschappen debuggen
Elk object in UNO weet welke eigenschappen, methoden en interfaces het al bevat. Apache OpenOffice BASIC verschaft eigenschappen die deze kunnen weergeven in de vorm van een tekenreeks die een lijst bevat. De overeenkomende eigenschappen zijn:
- DBG_properties
- geeft een tekenreeks terug die alle eigenschappen van een object bevat
- DBG_methods
- geeft een tekenreeks weer die alle methoden van een object bevat
- DBG_supportedInterfaces
- geeft een tekenreeks weer die alle interfaces bevat die een object ondersteunen.
De volgende programmacode toont hoe DBG_properties en DBG_methods kunnen worden gebruikt in echte toepassingen. Het creëert eerst de service com.sun.star.frame.Desktop en geeft dan de ondersteunde eigenschappen en methoden weer in berichtenvensters.
Dim Obj As Object Obj = createUnoService("com.sun.star.frame.Desktop") MsgBox Obj.DBG_Properties MsgBox Obj.DBG_methods
Wees er attent op dat bij het gebruik van DBG_properties de functie alle eigenschappen die een bepaalde service theoretisch kan ondersteunen weergeeft. Er is echter geen garantie dat deze ook kunnen worden gebruikt door het gevraagde object. In hele zeldzame gevallen moet u dus, vóór het opvragen van een eigenschap, eerst de functie IsEmpty gebruiken om te controleren of de eigenschap wel echt beschikbaar is.
Gereedschap om te debuggen
het gebruiken van de eigenschappen DBG_ is een hele ruwe methode om de inhoud van een object van de API te ontdekken.
Het venster Controle van de BASIC IDE kan de eigenschappen van een object van UNO weergeven (maar niet de methoden en niet de interfaces).
Gebruik in plaats daarvan programma Xray of programma MRI om alle beschikbare informatie van een object weer te geven en te koppelen aan de overeenkomende documentatie van de API.
Verwijzingen naar de API
Meer informatie over de beschikbare services en hun interfaces, methoden en eigenschappen kan worden gevonden in de verwijzingen voor de Apache OpenOffice API.
Content on this page is licensed under the Public Documentation License (PDL). |