Differenze tra le versioni di "Importare ed utilizzare librerie .gambas"

Versione delle 17:26, 13 mag 2013

In generale una Libreria è un insieme di comandi, e più segnatamente funzioni, esterno al codice del programma principale, che fornisce appunto ulteriori ed addizionali funzionalità.

In Gambas è possibile utilizzare, oltre alle librerie condivise esterne .so, anche librerie .gambas, contenenti proprietà e funzioni ricavabili dalle risorse messe a disposizione da Gambas.

Creare una libreria .gambas

La realizzazione di una libreria .gambas non richiede, ovviamente, che siano mostrate finestre e Form, e pertanto, all'atto della creazione del tipo di progetto va scelta l'opzione " Applicazione a riga di comando ".

Il progetto avrà, come struttura iniziale ovviamente un Modulo principale MMain.module, ma - volendo - ne potranno essere aggiunti anche altri. Si potranno, inoltre, utilizzare anche una o più Classi appositamente create all'interno della libreria.

V'è da sottolineare che, affinché le proprietà e le funzioni contenute in un Modulo o in una Classe di una libreria .gambas siano visibili in altri programmi Gambas, ossia possano essere lì utilizzate, bisognerà avere l'accortezza di porre all'inizio del Modulo e della Classe la parola: Export .

Si inseriranno successivamente nel Modulo e/o nella Classe le funzioni e le proprietà che si intende che la libreria metta a disposizione.

Infine, la libreria dovrà essere salvata con l'estensione .gambas :

nome_libreria.gambas

Richiamare una libreria .gambas

Va precisato che questo tipo di librerie, costituite da codice Gambas, vanno poste nella medesima directory del programma che le utilizzerà, altrimenti le librerie non saranno trovate dal programma.

Va precisato, altresì, che, a differenza dell'utilizzo delle librerie condivise esterne .so, non è necessario dichiarare in alcun modo la libreria .gambas all'interno del codice della Classe principale del programma. La libreria .gambas andrà richiamata nel percorso " Progetto-->Proprietà-->Libraries " dell'IDE del progetto.

Invocare una funzione o altra risorsa posta in una libreria .gambas

Come già detto si potranno invocare funzioni ed altre risorse che siano poste in Moduli e Classi creati nella libreria .gambas .

Chiamata di funzioni poste all'interno di Moduli

Per invocare una funzione contenuta in un Modulo della libreria, si dovrà scrivere nel programma principale il nome del Modulo che la contiene e quindi il nome della funzione desiderata, in qualità di metodo di quel Modulo. Volendo si potrà invocare la funzione o altra risorsa nel programma principale anche attraverso la dichiarazione di una variabile del tipo del Modulo, presente nella libreria, contenente la funzione o la risorsa desiderata.

Chiamata di funzioni poste all'interno di Classi

Per invocare, invece, una funzione o un'altra risorsa contenuta in una Classe della libreria, sarà assolutamente necessario dichiarare nel programma principale una variabile del tipo della Classe, presente nella libreria, contenente la funzione o la risorsa desiderata, ed invocare quindi attraverso detta variabile la funzione o altra risorsa.

Chiamata da un Modulo di funzioni poste all'interno di Classi della medesima libreria

Parimenti, se deve essere invocata all'interno di un Modulo una funzione o altra risorsa posta in una Classe, entrambi presenti nella medesima libreria, la funzione ed ogni altra risorsa, presenti nella Classe, vanno invocate attraverso l'uso di una variabile dichiarata del tipo della Classe contenente la predetta funzione o risorsa.

Esempio pratico

Facciamo un esempio pratico, nel quale avremo una libreria, che chiameremo ad esempio lib.gambas, ed un programma Gambas che ne richiama le funzioni presenti in una Classe ed in un Modulo di quella libreria.

Nella Classe, Classe1.class, della libreria avremo il seguente codice:

Export


Public Function funzClasse(a As Integer) As Integer
 
 Dim b As Integer
 
   b = a * 7
   
   Return b
 
End

Nel Modulo, Module1.module, della libreria avremo il seguente codice analogo:

Export


Public Function funzModulo(a As Integer) As Integer
 
 Dim b As Integer
 
   b = a + 7
   
   Return b
 
End

Poi, nella Classe principale del programma avremo il seguente codice:

Public Sub Button1_Click()

 Dim cl As New Class1  ' Dichiariamo una variabile del tipo della Classe della libreria contenente la funzione da invocare
 Dim w, y As Integer

' Viene richiamata la funzione nella Classe della libreria ".gambas" :
   w = cl.funzClasse(5)
 
   Print w

 
' Viene richiamata la funzione nel Modulo della libreria ".gambas" :
   y = Module1.funzModulo(w)
 
   Print y
 
End

Ricordiamo che il programma e la predetta libreria .gambas devono stare nella medesima directory.