Difference between revisions of "EN/Documentation/BASIC Guide/UNO Tools"
(New page: {{DISPLAYTITLE:UNO の関連ツール}} {{EN/Documentation/BASICGuideTOC/v2 |ShowPrevNext=block |ShowPrevPage=block |PrevPage=Documentation/BASIC Guide/Modules, Services and Interfaces |Ne...) |
|||
| Line 1: | Line 1: | ||
| − | {{DISPLAYTITLE:UNO | + | {{DISPLAYTITLE:Strumenti per lavorare con UNO}} |
{{EN/Documentation/BASICGuideTOC/v2 | {{EN/Documentation/BASICGuideTOC/v2 | ||
|ShowPrevNext=block | |ShowPrevNext=block | ||
| Line 8: | Line 8: | ||
}} | }} | ||
| − | UNO | + | Per quanto riguarda gli oggetti (o i servizi, secondo la terminologia UNO) rimane la questione di quali sono le proprietà, i metodi e le interfacce supportati e come determinarli. Oltre al presente manuale, è possibile ricavare ulteriori informazioni sugli oggetti dalle seguenti fonti: il metodo <tt>supportsService</tt>, i metodi di debug nonché la Developer's Guide e il riferimento dell'API. |
| − | ==<tt>supportsService</tt> | + | == Il metodo <tt>supportsService</tt>== |
| − | <tt> | + | Diversi oggetti UNO supportano il metodo <tt>supportsService</tt>, con il quale è possibile determinare se un oggetto supporta un particolare servizio o meno. La chiamata seguente, ad esempio, determina se l'oggetto<tt>TextElement</tt> supporta il servizio <idl>com.sun.star.text.Paragraph</idl>. |
<source lang="oobas"> | <source lang="oobas"> | ||
| Line 18: | Line 18: | ||
</source> | </source> | ||
| − | == | + | == Proprietà di debug == |
| − | {{OOo}} Basic | + | Ogni oggetto UNO in {{OOo}} Basic sa quali proprietà, metodi e interfacce contiene già. Fornisce infatti proprietà che restituiscono queste informazioni sotto forma di elenco. Le proprietà corrispondenti sono le seguenti: |
| − | ;<tt>DBG_properties</tt>: | + | ;<tt>DBG_properties</tt>:Restituisce una stringa contenente tutte le proprietà di un oggetto |
| − | ;<tt>DBG_methods</tt>: | + | ;<tt>DBG_methods</tt>:Restituisce una stringa contenente tutti i metodi di un oggetto |
| − | ;<tt>DBG_supportedInterfaces</tt>: | + | ;<tt>DBG_supportedInterfaces</tt>:Restituisce una stringa contenente tutte le interfacce che supportano un oggetto |
| − | + | Il seguente codice di programma mostra come utilizzare <tt>DBG_properties</tt> e <tt>DBG_methods</tt> a scopo pratico. Si procede prima a creare il servizio <idl>com.sun.star.frame.Desktop</idl>e quindi a visualizzare le proprietà e i metodi supportati nelle finestre di messaggio. | |
<source lang="oobas"> | <source lang="oobas"> | ||
| Line 36: | Line 36: | ||
</source> | </source> | ||
| − | <tt>DBG_properties</tt> | + | Per l'uso di <tt>DBG_properties</tt>, osservare che la funzione restituisce tutte le proprietà supportate in via teorica da un servizio specifico. Non viene tuttavia fornita alcuna assicurazione sul fatto che tali proprietà siano utilizzabili con l'oggetto in questione. Prima di richiamare le proprietà, dovrete pertanto usare la funzione <tt>IsEmpty</tt> per controllare che siano effettivamente disponibili. |
| − | == API | + | == Riferimento API == |
| − | + | Per ulteriori informazioni sui servizi disponibili e le relative interfacce, metodi e proprietà, consultare il [http://api.openoffice.org/docs/common/ref/com/sun/star/module-ix.html riferimento dell'API di {{OOo}}]. | |
{{PDL1}} | {{PDL1}} | ||
{{InterWiki_Languages_BasicGuide|articletitle=Documentation/BASIC Guide/UNO Tools}} | {{InterWiki_Languages_BasicGuide|articletitle=Documentation/BASIC Guide/UNO Tools}} | ||
Latest revision as of 18:22, 25 June 2009
Template:EN/Documentation/BASICGuideTOC/v2
Per quanto riguarda gli oggetti (o i servizi, secondo la terminologia UNO) rimane la questione di quali sono le proprietà, i metodi e le interfacce supportati e come determinarli. Oltre al presente manuale, è possibile ricavare ulteriori informazioni sugli oggetti dalle seguenti fonti: il metodo supportsService, i metodi di debug nonché la Developer's Guide e il riferimento dell'API.
Il metodo supportsService
Diversi oggetti UNO supportano il metodo supportsService, con il quale è possibile determinare se un oggetto supporta un particolare servizio o meno. La chiamata seguente, ad esempio, determina se l'oggettoTextElement supporta il servizio com.sun.star.text.Paragraph.
Ok = TextElement.supportsService("com.sun.star.text.Paragraph")
Proprietà di debug
Ogni oggetto UNO in Apache OpenOffice Basic sa quali proprietà, metodi e interfacce contiene già. Fornisce infatti proprietà che restituiscono queste informazioni sotto forma di elenco. Le proprietà corrispondenti sono le seguenti:
- DBG_properties
- Restituisce una stringa contenente tutte le proprietà di un oggetto
- DBG_methods
- Restituisce una stringa contenente tutti i metodi di un oggetto
- DBG_supportedInterfaces
- Restituisce una stringa contenente tutte le interfacce che supportano un oggetto
Il seguente codice di programma mostra come utilizzare DBG_properties e DBG_methods a scopo pratico. Si procede prima a creare il servizio com.sun.star.frame.Desktope quindi a visualizzare le proprietà e i metodi supportati nelle finestre di messaggio.
Dim Obj As Object Obj = createUnoService("com.sun.star.frame.Desktop") MsgBox Obj.DBG_Properties MsgBox Obj.DBG_methods
Per l'uso di DBG_properties, osservare che la funzione restituisce tutte le proprietà supportate in via teorica da un servizio specifico. Non viene tuttavia fornita alcuna assicurazione sul fatto che tali proprietà siano utilizzabili con l'oggetto in questione. Prima di richiamare le proprietà, dovrete pertanto usare la funzione IsEmpty per controllare che siano effettivamente disponibili.
Riferimento API
Per ulteriori informazioni sui servizi disponibili e le relative interfacce, metodi e proprietà, consultare il riferimento dell'API di Apache OpenOffice.
| Content on this page is licensed under the Public Documentation License (PDL). |
