Gambas-it.org - Wikipedia - Contributi dell'utente [it]

Guide della comunità

2014-07-01T13:11:29Z

Orionis: /* Collection */

Raccolta di guide sui componenti, sui metodi e sugli algoritmi del linguaggio Gambas, nonché su ogni altro argomento utile, scritti e mantenuti dalla comunità italiana Gambas-it

== Balloon ==

* [[Individuare l'ID di un Balloon]]

* [[Spostare un Ballon]]

== Cairo ==

* [[Spostare il testo con il mouse all'interno dell'area grafica]]

== Clipboard ==

* [[Uso della classe Clipboard]]

== Collection ==

* [[Richiamare un campo di una Collection in un'altra Collection]]

* [[Richiamare un'intera Collection nel campo di un'altra Collection]]

* [[Richiamare un metodo della Classe di un oggetto inserito in una Collection]]

* [[Confronto Array di Strutture verso Collezione di Classi]]

== ComboBox ==

* [[ComboBox: creare una lista da codice]]

== Componenti ==

* [[Attivare un Componente dinamicamente da codice]]

==== Realizzazione dei Componenti ====

* [[Come creare un componente]]

* [[Tutorial - creare un componente: il frame]]

==== Componenti della Comunità Gambas-it.org ====

* [[GridBox]]

* [[gb.strLib]]

== DBus ==

* [[Introduzione a DBus]]

== DialogBox ==

* [[Far mostrare una particolare estensione di file]]

* [[Far mostrare l´estensione dell´ultimo file precedentemente aperto]]

* [[Filtrare contemporaneamente con il Dialog.Filter più estensioni di file]]

* [[Caricare più file da aprire in sequenza]]

== Drag - Drop ==

* [[Codice essenziale per effettuare il Drag-Drop di un'immagine]]

* [[Codice essenziale per effettuare il Drag-Drop di un testo]]

* [[Mostrare il contenuto di un file di testo con il solo drop del file in un oggetto di testo]]

* [[Mostrare un'immagine con il Drop del suo file in una PictureBox]]

== DrawingArea ==

* [[Drag-Drop di un testo in una DrawingArea]]

* [[Generare un file immagine da una DrawingArea]]

* [[Mostrare tutte le sfumature di un colore]]

* [[Ruotare il testo in una DrawingArea]]

* [[Scrivere del testo in una DrawingArea]]

* [[Spostare con il mouse il testo in una DrawingArea]]

* [[Stampare il contenuto di una DrawingArea]]

== Editor ==

* [[Cercare una parola nel testo di un Editor]]

== File immagine particolari ==

* [[Struttura del formato BMP]]

* [[Struttura del formato XPM]]

* [[Struttura e gestione del file di tipo PNM]]

== Font ==

* [[Utilizzare Font senza installarli nel sistema]]

== Form e finestre ==

* [[Chiudere tutte le finestre aperte da un applicativo]]

* [[Creare un Form mediante la Classe Window]]

* [[Creare una finestra ed inserirvi del testo con le funzioni esterne di Libcaca]]

* [[Creare una finestra mediante le funzioni del API di OpenCV]]

* [[Creare una finestra mediante le funzioni del API di SDL]]

* [[Creare una finestra mediante le funzioni del API di X11]]

* [[Passare ad un Form un valore diverso da un Intero alla chiusura di un Form secondario]]

* [[Passare ad un Form un valore Integer alla chiusura di un Form secondario]]

* [[Semitrasparenza di un Form]]

* [[Sollevare l'evento _Resize al ridimensionamento di un Form secondario]]

== Funzioni ==

* [[Gestire Funzioni presenti in Moduli e Classi come oggetti]]

* [[Scrivere una Funzione]]

== Gambas con HTML e JavaScript ==

* [[Introduzione - uso necessario dell´oggetto WebView]]

==== Applicazioni specifiche ====

* [[Controllare i link all´interno di una pagina WEB]]

* [[Creare un ComboBox in una tabella e passare i suoi valori selezionati al codice Gambas]]

* [[Inserire dati con un InputBox senza bloccare il programma]]

* [[Mostrare una finestra tipo MessageBox senza bloccare il programma]]

* [[Passare un valore di tipo stringa dall´Html a Gambas e viceversa]]

* [[Testo scorrevole dall'alto verso il basso e viceversa]]

== Gambas3 & SubVersion ==

* [[Gambas3 & SubVersion]]

== Gestione dei dati audio e dei file audio ==

* [[Calcolare a priori la durata di un file audio]]

* [[Creare il blocco d'intestazione di un file WAV]]

* [[Creare un file WAV da un file .orc e un file .sco di Csound con le funzioni esterne del API di libcsound64]]

* [[Convertire un file audio mpeg in .wav con le funzioni esterne del API di mpg123]]

* [[Convertire un file OggVorbis in WAV con le funzioni esterne del API di Libvorbisidec]]

* [[Convertire un file OggVorbis in WAV ed estrarne anche informazioni con le funzioni esterne del API di VorbisFile]]

* [[Convertire un file WAV in formato AAC con l'API di Libvo-aacenc]]

* [[Convertire un file WAV in formato AAC con le funzioni esterne del API di Faac]]

* [[Creare un semplice Client di Jack]]

* [[Decomprimere e docodificare un file mp3 con le funzioni esterne del API di AVbin]]

* [[Eseguire un file audio ed estrarne informazioni mediante le funzioni esterne del API di libcsfml]]

* [[Eseguire un file audio mediante il codice html e mediante il codice javascript]]

* [[Eseguire un file audio mediante la proprietà Webview.Url]]

* [[Eseguire un file mp3 usando le API di mpg123 e di Alsa]]

* [[Eseguire un file mp3 usando l'API di Smpeg]]

* [[Eseguire un file WAV mediante le funzioni esterne del API di libaudiofile e di Alsa]]

* [[Eseguire un file WAV usando l'API di SndFile e di Alsa]]

* [[Estrarre da un file MP3 i soli dati audio grezzi mediante la libreria Libmad]]

* [[Estrarre da un file WAV i soli dati audio grezzi]]

* [[Estrarre i TAG da un file SPC con le funzioni esterne del API di Libspctag]]

* [[Estrarre informazioni da un file .wav]]

* [[Estrarre informazioni da un file MP3 con le funzioni esterne del API di Id3tag]]

* [[Estrarre informazioni da un file MP3 con le funzioni esterne del API di Smpeg]]

* [[Estrarre informazioni da un file OggVorbis con le funzioni esterne del API di Vorbisfile]]

* [[Estrarre informazioni e TAG da file audio con le funzioni esterne del API di LibTagC]]

* [[Estrarre informazioni e TAG da un file MP3 con le funzioni esterne del API di Avbin]]

* [[Estrarre informazioni e TAG da un file MP3 con le sole funzioni di Gambas]]

* [[Estrarre informazioni e TAG da un file OggVorbis con le sole funzioni di Gambas]]

* [[Estrarre informazioni generali da un file audio con le funzioni esterne del API di Sox]]

* [[Fondere insieme due file WAV]]

* [[La struttura di un file MPEG]]

* [[La gestione mediante il componente gb.media]]

* [[La gestione mediante il componente gb.openal]]

* [[La gestione mediante il componente gb.sdl.sound]]

* [[La gestione mediante le funzioni esterne delle API di Alsa]]

* [[La gestione mediante le funzioni esterne del API di Canberra]]

* [[La gestione mediante le funzioni esterne delle API di GStreamer]]

* [[La gestione mediante le funzioni esterne dell'API di Lame]]

* [[La gestione mediante le funzioni esterne delle API di LibAo]]

* [[La gestione mediante le funzioni esterne dell'API di OpenAL]]

* [[La gestione mediante le funzioni esterne del API di PortAudio e SndFile]]

* [[La gestione mediante le funzioni esterne dell'API di PulseAudio]]

* [[La gestione mediante le funzioni esterne dell'API di SDL]]

* [[La gestione mediante le funzioni esterne del API di Sox]]

* [[La gestione mediante le funzioni esterne del API di VLC]]

* [[Ottenere un file di dati audio grezzi da un file .pat]]

* [[Ottenere un file WAV da un file Midi]]

* [[Unire due file WAV]]

* [[Visualizzare la forma d'onda di un file WAV]]

==== Ascolto radio da flusso web ====

* [[Riproduzione dell'audio di radio WEB con le funzioni esterne del API di GStreamer]]

* [[Riproduzione dell'audio di radio WEB con le funzioni esterne del API di VLC]]

* [[Riproduzione dell'audio di radio WEB con l'oggetto WebView e con il codice HTML]]

==== Codifica del parlato e decodifica dei dati codificati ====

* [[Codifica del parlato mediante le funzioni esterne del API di Speex]]

* [[Decodifica dei dati precedentemente codificati mediante le funzioni esterne del API di Speex]]

==== Dal testo al parlato (Text-To-Speech) ====

* [["Dal testo al parlato" mediante le funzioni esterne del API di eSpeack]]

* [["Dal testo al parlato" mediante le funzioni esterne del API di Pico TTS]]

* [["Dal testo al parlato" mediante le funzioni esterne del API di Speech-Dispatcher]]

==== I/O audio ====

* [[Conoscere con le funzioni esterne di ALSA i dispositivi audio presenti nel sistema]]

* [[Rilevare se la scheda audio sta processando dati audio]]

* [[Sapere con le funzioni esterne di ALSA quali schede audio sono installate nel computer]]

== Gestione dei dati MIDI e dei file ''.mid''==

* [[Conoscere la durata di un file Midi mediante le funzioni esterne del API di Allegro]]

* [[Creare un semplice Client Midi di Jack]]

* [[Eliminare una traccia da un file MIDI]]

* [[Eseguire un file MIDI mediante il codice html e mediante il codice javascript]]

* [[Eseguire un file MIDI mediante il componente gb.media]]

* [[Eseguire un file MIDI mediante il componente gb.openal]]

* [[Eseguire un file MIDI mediante il componente gb.sdl.sound]]

* [[Fondere insieme due file MIDI]]

* [[Intercettare dati Midi grezzi con le funzioni esterne del API di PortMidi]]

* [[La gestione dei file MIDI mediante le funzioni esterne del API di GStreamer]]

* [[La gestione dei file MIDI mediante le funzioni esterne del API di Fluidsynth]]

* [[La gestione dei file MIDI mediante le funzioni esterne del API di OpenAl]]

* [[La gestione dei file MIDI mediante le funzioni esterne del API di SDL]]

* [[La gestione dei file MIDI mediante le funzioni esterne del API di VLC]]

* [[La gestione dei file MIDI mediante le funzioni esterne del API di WildMidi]]

* [[Gestione del MIDI con ALSA]]

* [[Gestione del MIDI con O.S.S.]] (obsoleto)

==== I/O Midi ====

* [[Conoscere con le funzioni esterne di ALSA i dispositivi Midi presenti nel sistema]]

* [[Conoscere con le funzioni esterne di PortMidi le porte Midi disponibili nel sistema]]

* [[Conoscere con le funzioni esterne di TSE3 le porte Midi disponibili nel sistema]]

* [[Conoscere i Client Midi di ALSA correnti attivi nel sistema ]]

== Gestione dei File ==

* [[Arrestare temporaneamente l'intercettazione del flusso di dati da un file-device]]

* [[Azzerare un gruppo di byte in un file]]

* [[Conoscere a quale applicazione è associato un tipo di file]]

* [[Conoscere ed impostare i permessi di un file]]

* [[Conoscere la dimensione di un file]]

* [[Eliminare un byte all'interno di un file binario]]

* [[Estrarre da una cartella uno o più file nascosti]]

* [[Estrarre il percorso di un file]]

* [[Estrarre l'icona di un tipo di file]]

* [[Identificare un tipo di file dal suo mimetype]]

* [[Identificare un tipo di file dalla sua estensione]]

* [[Leggere dati dai "File Descriptor" passati da funzioni esterne]]

* [[Leggere un file con READ]]

* [[Leggere un file di testo]]

* [[Ottenere un file coerente da dati di tipo stringa]]

* [[Percorso assoluto e percorso relativo dei file]]

* [[Reindirizzare lo standard output con Output To]]

* [[Riempire un vettore di tipo Byte senza Read]]

* [[Salvare in un file le stringhe contenute in un vettore di tipo Stringa]]

* [[Sapere se un file di nome sconosciuto è stato creato]]

* [[Scaricare un file da internet]]

* [[Scrivere all'interno di un file di testo]]

* [[Scrivere in un file i dati presenti in un vettore di tipo Byte]]

* [[Scrivere in un file solo alcuni dati presenti in un'area riservata di memoria]]

* [[Scrivere in un vettore i dati di un file]]

* [[Scrivere un file di testo]]

== Gestione dei file PDF ==

* [[Codice essenziale per mostrare un file PDF]]

* [[Creare un file PDF]]

* [[Stampare un file PDF]]

== Gestione dei processi mediante "Process" ==

* [[Apertura e chiusura di un processo mediante Process]]

* [[Attendere e verificare la chiusura di un programma gestito da Process]]

* [[Lettura dati da un Processo e scrittura dati in un Processo]]

== Gestione del CD-ROM ==

* [[Individuare con le funzioni dell'API di SDL i drive CD-ROM connessi al sistema]]

== Gestione delle immagini ==

* [[Cancellare una immagine in una PictureBox]]

* [[Creare da codice un'immagine trasparente]]

* [[Fondere due immagini in una sola]]

* [[Immagine di sfondo al testo in una TextEdit ed in una TextLabel]]

* [[Immagine scorrevole]]

* [[Immagine tratta dal WEB resa lampeggiante]]

* [[Imporre un colore uniforme semitrasparente su una immagine]]

* [[Individuare il colore di un determinato pixel]]

* [[Inserire del testo in una Image ed in una Picture]]

* [[Modi di caricare un'immagine di tipo ''Picture'']]

* [[Mostrare un'immagine in una finestra con le funzioni dell'API di OpenCV]]

* [[Mostrare un'immagine BMP in una finestra con le funzioni del API di SDL]]

* [[Mostrare una parte di un'immagine]]

* [[Rendere semitrasparente una immagine]]

* [[Rendere trasparente una immagine in base ad un colore specifico]]

* [[Ruotare specularmente una immagine ed un carattere]]

* [[Ruotare una immagine sul proprio asse centrale]]

* [[Scaricare una immagine da un sito internet]]

* [[Utilizzare una GIF animata]]

== GridView ==

* [[Aggiungere righe mediante un tasto]]

* [[Cambiare il colore di fondo di una riga cliccata e far tornare quello di un'altra al colore iniziale]]

* [[Centrare il testo nell'header]]

* [[Drag-Drop di un'immagine in una cella di una GridView]]

* [[Drag-Drop di un testo da una cella di una GridView ad una cella di un'altra GridView]]

* [[Effettuare una ricerca nelle celle]]

* [[Header contenente due o più righe]]

* [[Impostare due parole ciascuna all'estremità opposta di una cella]]

* [[Impostare le righe e le colonne ed assegnare a ciascuna cella un valore di un array bidimensionale]]

* [[Impostare font, colore dei caratteri e colore di sfondo diversi per ogni cella]]

* [[Individuare la cella nella quale si è cliccato]]

* [[Inserire un'immagine adattandola alle dimensioni della cella]]

* [[Ordinare i valori all'interno di una colonna]]

* [[Ordinare i valori di più righe in base ad una colonna]]

* [[Unire in una GridView le celle in un'unica grande cella]]

== InputBox ==

* [[Impostare le dimensioni di un InputBox]]

== Interagire con la tastiera ==

* [[Individuare i tasti della tastiera intercettando i dati grezzi dal suo file-device]]

* [[Keypress - Keyrelease - Key]]

== Interfaccia a linea di comando ==

* [[CLI]]

== Interfacciare Gambas con librerie esterne .so==

* [[Documento originale (Inglese)]]

* [[Traduzione della comunità di Gambas-it]]

==== Ulteriori contributi sulle librerie e sulle funzioni esterne ====

* [[Extern: richiamare funzioni esterne a Gambas]]

* [[Avviare con l'appoggio di una libreria esterna un semplice sorgente C senza compilarlo]]

* [[Creare una Libreria condivisa (Shared Library) .so]]

* [[Dereferenziare senza Memory-Stream un pointer ad una Struttura, passato da una funzione esterna]]

* [[Gestire con sicurezza le Strutture esterne]]

* [[Ottenere l'indirizzo ed il valore di una variabile globale situata in una libreria condivisa]]

* [[Passare un`area riservata di memoria ad una funzione esterna]]

* [[Richiamare con l'appoggio di una libreria esterna una funzione presente in un sorgente C]]

* [[Verificare quali dati Gambas passa ad una funzione esterna]]

==== Richiamo ed uso di particolari funzioni esterne ====

* [[atoi()]]
* [[Creare una mappatura della memoria mediante mmap()]]
* [[FcStrPlus ()]]
* [[fopen ()]]
* [[isalnum()]]
* [[iscntrl()]]
* [[isprint()]]
* [[memcpy ()]]
* [[memset ()]]
* [[printf ()]]
* [[scanf()]]
* [[strcat()]]

==== Scrivendo particolari librerie esterne in C ====

* [[Scrivere una libreria esterna alla quale viene passata una stringa e che ritorna una stringa]]

* [[Scrivere una libreria esterna che chiama funzioni esterne puntate contenute in un Vettore]]

* [[Scrivere una libreria esterna che chiama funzioni esterne puntate contenute in una Struttura]]

* [[Scrivere una libreria esterna che chiama una funzione esterna puntata]]

* [[Scrivere una libreria esterna che chiama una funzione puntata membro di una Struttura ed un'altra indipendente]]

* [[Scrivere una libreria esterna che ritorna un valore attraverso un parametro di una sua funzione]]

* [[Scrivere una libreria esterna che ritorna un puntatore ad un buffer di tipo char]]

* [[Scrivere una libreria esterna che ritorna un Vettore di tipo char]]

* [[Scrivere una libreria esterna che ritorna una Struttura]]

* [[Scrivere una libreria esterna contenente una Funzione di Callback che chiama una Funzione Callback in Gambas]]

== Librerie .gambas ==

* [[Importare ed utilizzare librerie .gambas]]

==== Librerie della Comunità Gambas-it.org ====

* [[datiMidigrezzi.gambas]]

* [[lib.Alsa.Seq.Midi.gambas]]

* [[libAlureMidi.gambas]]

* [[Libfluidmidi.gambas]]

* [[RTFLib.gambas]]

* [[strLib.gambas]]

* [[trasparente.gambas]]

====Classi della Comunità Gambas-it.org====

* [[Fifo]]

* [[TrasfImpLett]]

== ListBox ==

* [[Assegnare ad un oggetto di testo il contenuto di un elemento cliccandovi sopra]]
* [[Inserire un array di dati di tipo stringa]]

== Matrici e Vettori ==

* [[Array di Array]]

* [[Array dinamici – creazione e riempimento]]

* [[Convertire i valori di tipo Byte di un vettore in valori di tipo Stringa]]

* [[Gestione di una coda mediante array in modo circolare]]

* [[Matrici (Vettori multidimensionali) definite]]

* [[Ottenere un vettore di tipo Byte da una Stringa]]

* [[Utilizzare un Vettore al posto di una Matrice]]

* [[Variare successivamente il numero degli elementi di un vettore]]

== Menu ==

* [[Creare Menu a finestra]]

* [[Creare Menu da codice e non con l´Editor-Menu]]

* [[Far apparire un Balloon, quando si passa con il mouse su un menu]]

* [[Modifiche delle proprietà dei Menu]]

== MessageBox ==

* [[Impostare le dimensioni del MessageBox]]

* [[Individuare l'ID della finestra di un MessageBox generato da un programma]]

* [[Interruzione di riga con ritorno a capo]]

* [[Spostare o ridimensionare una finestra di un MessageBox]]

== Miscellanea ==

* [[Cliccare in un oggetto qualsiasi o in una immagine suddivisi in rettangoli]]

* [[Conoscere il fuso orario (TimeZone) impostato nel proprio sistema]]

* [[Conoscere la versione di Gambas]]

* [[Conoscere l'hostname impostato nel proprio sistema]]

* [[Controllare la temperatura dell'hardware mediante le funzioni del API di libsensors]]

* [[Conversione di un angolo]]

* [[Disegnare "a mano" su un contenitore diverso da una DrawingArea]]

* [[Estrarre il valore di una costante definita in un file d'intestazione in C]]

* [[Individuare con precisione il percorso ed il nome della Scrivania]]

* [[Leggere in una cartella]]

* [[Modificare il "passo" del ciclo For]]

* [[Ottenere informazioni sugli schermi disponibili mediante le funzioni del API di X11]]

* [[Ottenere la lista di tutti i dispositivi USB attivi nel sistema]]

* [[Ottenere una schermata ("screenshot") con Gambas]]

* [[Visualizzare il tempo trascorso dall'ultimo avvio del sistema]]

== Mouse ==

* [[Evento rotellina]]

* [[Intercettare i dati del mouse dal suo file-device]]

* [[Intercettare il tasto premuto del mouse]]

* [[Modificare l´aspetto del cursore]]

* [[Spostare da codice il mouse sullo schermo]]

== Oggetti in generale ==

* [[Assegnare da codice più oggetti ad un Gruppo]]

* [[Assegnare un valore ad una proprietà di un oggetto]]

* [[Creare array di oggetti]]

* [[Creare e dimensionare un oggetto con lo spostamento del mouse sul form]]

* [[Creare più oggetti del medesimo tipo senza variabile array]]

* [[Impedire che un oggetto sollevi qualsiasi evento]]

* [[Incrementare e decrementare la quantità di oggetti cliccando rispettivamente sull'ultimo e sul penultimo creato]]

* [[Individuare una Classe di oggetti fra molti]]

* [[Istanziare un oggetto mediante la Classe "Object"]]

* [[Metodi _New() e _Free() degli oggetti]]

* [[Metodo di pseudo indirizzamento ad Oggetti grafici]]

* [[Modificare il valore di una proprietà ad una parte di più oggetti conosciuti del medesimo tipo]]

* [[Oggetti scorrevoli]]

* [[Raggiungere e gestire gli oggetti di FMain da una classe secondaria]]

* [[Richiamare e gestire più oggetti assegnati a variabili con medesimo identificatore]]

* [[Richiamare un Metodo di un oggetto con la Classe Object]]

* [[Riclassificare successivamente un oggetto]]

* [[Riposizionare in modo circolare più oggetti posti in pila]]

* [[Riposizionare in pila più oggetti in base ad una loro proprietà]]

* [[Sapere l´oggetto che ha scatenato l´evento]]

* [[Sapere se un oggetto è un'istanza di una determinata Classe]]

* [[Spostare oggetti con il mouse all'interno di un contenitore senza Drag & Drop]]

* [[Spostare o ridimensionare un oggetto a seconda del punto ove si clicca]]

* [[Utilizzare la proprietà .Tag come un array di tipo Variant]]

* [[Verificare l´esistenza di un oggetto]]

== Password ==

* [[Inserire le password per lanciare comandi]]

== Pdfwriter ==

*[[Guida ai report]]

== Porte ==

* [[Accesso alle Porte Seriali]]

* [[Approfondimento sull'accesso alle porte USB]]

* [[Uso delle Porte Parallele]]

== Posta elettronica ==

* [[Invio della posta elettronica]]

== Programmi Gambas e programmi esterni ==

* [[Agire sulla finestra di un qualunque programma]]

* [[Chiudere programmi esterni]]

* [[Conoscere in tempo reale il numero dell´ultimo processo appena aperto]]

* [[Contare le righe di codice di un progetto Gambas]]

* [[Copiare in una cartella un programma.gambas contenuto in un altro programma.gambas]]

* [[Estrarre l'icona di un programma associato ad un file]]

* [[Impedire l'avvio di un programma.gambas già avviato]]

* [[Indirizzare dati da un programma ad un altro e ad un Terminale]]

* [[Individuare ed estrarre il PID di un programma]]

* [[Individuare ed estrarre l'ID della finestra di un programma ]]

* [[Individuare il nome della finestra di un programma]]

* [[Individuare il nome di un programma]]

* [[Individuare il percorso di un programma]]

* [[Individuare il percorso ove risiede la cartella del progetto Gambas]]

* [[Intercettare i dati inviati allo standard output da un programma C]]

* [[Lanciare un programma Gambas da linea di comando]]

* [[Lanciare un programma senza Shell, ma da una finestra di un Terminale]]

* [[Porre la finestra di un programma esterno in primo piano]]

* [[Ricevere un 'segnale' da un programma C]]

* [[Salvare un file nella Directory di Lavoro di un programma Gambas]]

* [[Spostare la finestra di un programma da un desktop ad un altro del video]]

* [[Usare due programmi Gambas contemporaneamente mediante Process, lo standard Output e lo standard Input]]

* [[Usare due o più programmi Gambas contemporaneamente mediante Alsa]]

== Scripting ==
* [[Scripting con Gambas]]

== Slider ==

* [[Mostrare il segna-tacche lungo lo Slider]]

* [[Variare il valore dello Slider ruotando la rotellina del mouse]]

== SpinBox ==
* [[Variare il valore da codice e non con il controllo diretto del mouse]]

== Spinner ==
* [[Uso dello ''Spinner'']]

== Stampa ==

* [[Individuare le stampanti presenti nel proprio sistema]]

* [[Stampare elementi diversi da testo, da Image e da Picture]]

* [[Stampare il testo presente in oggetti di testo]]

* [[Stampare un file con le funzioni del API di cups]]

== Stringhe, caratteri e testo ==

* [["Andare a capo" in un oggetto di testo]]

* [[Cercare una parola in una stringa]]

* [[Confrontare i caratteri di due stringhe]]

* [[Convertire in stringa senza funzioni il contenuto di una variabile non di tipo Stringa]]

* [[Inserire in una stringa caratteri ASCII non stampabili]]

* [[Modificare in maiuscolo il primo carattere di una stringa]]

* [[Mostrare del testo al di sopra di una immagine avendo una PictureBox ed un oggetto di testo]]

* [[Mostrare il simbolo dell'Euro]]

* [[Porre a "Null" tutti gli elementi di un vettore di tipo Stringa]]

* [[Scomporre una stringa e caricare ogni parola in una variabile array]]

* [[Scritta lampeggiante]]

* [[Scritta scorrevole]]

* [[Simulazione di un collegamento ipertestuale]]

* [[Testo verticale]]

* [[Verifica "passo-passo" di ciascun carattere in una data stringa]]

== SwitchButton ==

* [[Uso dello "SwitchButton"]]

== TabPanel ==

* [[Impostare l'immagine ed il colore del titolo delle tabelle]]

* [[Inserire tabelle ed oggetti al loro interno]]

== TabStrip ==

* [[Aggiungere successivamente linguette via codice]]

* [[Aggiungere oggetti in una determinata linguetta]]

* [[Inserire più linguette ed oggetti via codice]]

== Tavoletta grafica e Gambas ==

* [[Leggere l´azione di una penna su una Tavoletta grafica]]

== Tempo, Date e Temporizzazioni ==

* [[Convertire i millisecondi in formato minuti:secondi.millisecondi]]

* [[Convertire i secondi in formato ore:minuti:secondi]]

* [[Creare un Cronometro]]

* [[Formattare "hh:nn:ss" dai soli secondi]]

* [[Gestione del tempo mediante le funzioni esterne del API di Libcsfml]]

* [[Ottenere una data e-o l'orario comprensivo dei millisecondi]]

* [[Temporizzare una funzione o un evento]]

== Terminale - Console IDE Gambas==

* [[Conoscere la riga e la colonna nelle quali è posizionato il cursore in un Terminale]]

* [[Intercettare dati inviati al programma dal sistema o da altri programmi utilizzati]]

* [[Intercettare quanto viene scritto manualmente nella console o in un Terminale]]

* [[Inviare il testo, colorato e ruotato, in un Terminale con l'API di libcaca]]

* [[Modalità di scrittura nella console dell'IDE di Gambas]]

* [[Modificare il prompt bash]]

* [[Pulire il Terminale via codice]]

* [[Pulire la console via codice con la Classe "Desktop"]]

* [[Raccogliere quanto mostrato nella finestra di un Terminale]]

* [[Reindirizzare dati stringa dalla console ad un file]]

* [[Rendere la console dell'IDE funzionale come un Terminale]]

* [[Scrivere nella finestra del Terminale]]

* [[Spostare da codice il cursore all'interno del Terminale]]

* [[Spostare il cursore in un Terminale lungo una riga di caratteri]]

== ToolTip ==

* [[Chiudere un ToolTip anticipatamente]]

== Valori numerici e bit==

* [[Arrotondamento di un numero con virgola mobile]]

* [[Azzerare tutti gli elementi di un vettore di tipo numerico]]

* [[Conversione in Base64]]

* [[Conversione Big-Endian/Little-Endian]]

* [[Convertire un numero da rappresentazione binaria in decimale]]

* [[Convertire un numero da rappresentazione Decimale a Carattere ASCII]]

* [[Convertire un numero da rappresentazione Decimale ad Esadecimale]]

* [[Convertire un numero da rappresentazione Esadecimale a Decimale]]

* [[Convertire un numero da rappresentazione ottale in decimale]]

* [[Convertire un numero decimale in numerazione romana]]

* [[Distinguere ogni byte della rappresentazione esadecimale di un valore decimale]]

* [[Ottenere i "reali" valori numerici da una lettura di tipo Stringa di un flusso di dati]]

* [[Ottenere il ''nibble'' alto ed il ''nibble'' basso di un numero]]

* [[Rappresentazione esadecimale di un dato in formato "a lunghezza variabile"]]

* [[Sapere se un numero è pari o dispari]]

* [[Sostituire gli operatori logici di spostamento dei bit con semplici operazioni]]

* [[Troncare alcune cifre decimali in un valore Float]]

== Video ==

* [[Conoscere il numero di titoli e di capitoli presenti in un DVD con l'API di libdvdread4]]

* [[Gestione dei file video con il componente gb.media]]

* [[Gestione dei file video con le funzioni esterne delle API di GStreamer]]

* [[Gestione dei file video con le funzioni esterne del API di LibVLC]]

* [[Gestione dei file video con WebView e gestione con il codice HTML]]

== Web ==

* [[Acquisire il codice HTML di una pagina web]]

Confronto Array di Strutture verso Collezione di Classi

2014-07-01T13:08:08Z

Orionis:

<h2>Confronto Array di Strutture verso Collezione di Classi</h2>

Per chi proviene in Gambas da MS VB la definizione e la gestione di strutture dati personalizzate può essere fonte di
confusione.
In genere, l'utente medio VB è abituato ad utilizzare array di strutture ('custom types').
 
Altri preferiscono utilizzare le Classi, con relative proprietà e metodi, e le Collection; in questo caso l'approccio a
Gambas non comporta variazioni sostanziali.
 
La differenza sostanziale tra Array e Collection è data dalla differente metodologia di accesso agli elementi. 
Gli Array sono per loro natura 'posizionali', ovvero la posizione in memoria è sequenziale e stabilita dalla dimensione e
dall'indice progressivo del singolo elemento.
 
Le Collection sono gestite autonomamente dal compilatore e la posizione degli elementi non è determinata; l'accesso avviene
tramite un indice chiave ('Key').
 
Lo scopo di questo documento è di fornire alcune informazioni sulle differenze tra i due approcci, con vantaggi e svantaggi,
e una sintetica valutazione prestazionale.
 
Per ciascun approccio saranno presentate le 3 operazioni fondamentali di gestione liste, ovvero Accesso, Aggiunta,
Eliminazione.


<h3>Definizione di STRUTTURE</h3>

Per gli esempi che seguino consideremo una semplicissima struttura dati composta da due proprietà, definita in Gambas con:
 
<code>
PUBLIC STRUCT Contatto 
ID As Integer
nome As String 
telefono As String 
END STRUCT
</code>


<h3>Definizione di CLASSI</h3>

L'uso di classi comporta la consueta creazione di un documento di classe (es. clsContatto) che esponga le stesse
proprietà viste sopra e dei metodi per la gestione delle stesse.
Si crea dunque il nuovo documento 'clsContatto' (Attenzione: deve avere la definizione all'inizio <code>CREATE
STATIC</code>).
 
<code>
'Class clsContatto 
CREATE STATIC 
PROPERTY Nome As String 
PROPERTY Telefono As String 
 
PRIVATE $iID As Integer 'proprietà utilizzata internamente per generare una nuova chiave 
PRIVATE $sNome As String 
PRIVATE $iTelefono As String 
</code>
 
E' consigliabile usare questo approccio che prevede di 'nascondere' le proprietà interne della classe ed accedere ad esse
solo tramite chiamate ai metodi pubblici esposti.
In questo modo, oltre alla maggiore flessibilità di modifica della classa, si delega alla classe il compiti di validazione
dei parametri.


 

<h3>ARRAY</h3>


In Gambas gli array di strutture possono essere statici o dinamici, ovvero a dimensioni prestabilite oppure variabili.


<h4>Array statici</H4>

Gli Array statici sono di scarso interesse in quanto la loro dimensione è 'hard coded' nel sorgente, quindi sono per
niente flessibili. Ciò che segue è quindi sono allo scopo di completezza d'informazione e non sarà utilizzato negli esempi.
 
NOTA: in VB non esiste il concetto di Array statico in quanto può essere in qualsiasi momento ridimensionato con le
istruzioni REDIM [PRESERVE}
 
La dichiarazione di un array statico di 10 strutture Contatto si scrive: 
<code>PUBLIC miaAgenda[10] as STRUCT Contatto</code>


<h4>Array dinamici</H4>

La dichiarazione di Array dinamici è sottilmente, ma sostanzialmente, diversa:
 
<code>PUBLIC miaAgenda as NEW Contatto[]</code>
 
Si noti l'ovvia assenza del numero di elementi, l'uso di NEW e la diversa posizione delle parentesi quadre.
 
NOTA 1: per Gambas gli Array dinamici non sono altro che degli oggetti (classi), per cui valgono proprietà e metodi
ereditati dalla classe madre 'Object'.
 
Ne consegue che l'utilizzo come Array piuttosto che come classi è più una scelta dell'utilizzatore che pratica, tranne
nell'enumerazione degli elementi.
 
NOTA 2: se si vuole utilizzare un Modulo esterno al Form principale (per pulizia del codice) per la gestione dei
dati, è obbligatorio copiare esattamente la dichiarazione della struttura ANCHE nel Form. 
 
Per ridimensionate l'array (in VB si scriverebbe <code>Redim Preserve miaAgenda(11)</code>); in Gambas occorre procedere in
3 fasi:
 
1. si aumenta la dimensione dell'array con: <code>miaAgenda.Resize(11)</code> 
2. si istanzia un nuovo elemento 'Contatto' con: <code>nuovoContatto as New Contatto</code> 
3. si aggiunge il nuovo elemento vuoto con: <code>miaAgenda.Add(nuovoContatto)</code> 
 

<h4>Enumerazione e accesso agli elementi</H4>

Accedere a tutti (enumerazione) o ad un elemento dell'Array è identico al metodo usato in VB, con l'unica avvertenza di
usare le parentesi quadre invece che tonde, per cui:
 
<code>
Dim cliente AS Contatto 
Dim numero AS String 
Dim k as Integer 
 
'per recuperare il valore di un campo dal record n°5: 
numero = miaAgenda[5].telefono 
 
'per recuperare l'intero record dall'agenda: 
For k=1 To miaAgenda.Count 
cliente = miaAgenda[k] 
.... 
Next 
</code>


<h4>Inserimento di elementi</H4>

Si incrementa come prima cosa la dimensione dell'array, come già visto, e poi si procede ad aggiungere i nuovi valori:
 
<code>
Static IdCount As Integer 
Dim nuovoContatto As Contatto 
 
IdCount = IdCount + 1 
miaAgenda.Resize(miaAgenda.Count+1) 
nuovoContatto as New Contatto 
nuovoContatto.ID = IdCount
nuovoContatto.Nome = "Pippo" 
nuovoContatto.Telefono = 333-123456 
miaAgenda.Add(nuovoContatto) 
</code>


<h4>Cancellazione elementi</H4>

In VB l'eliminazione di un elemento richiede lo spostamento di tutti gli elementi superiori a quello voluto e
successivamente il ridimensionamento dell'array. Gambas mette invece a disposizione il metodo Remove che elimina
l'elemento e sposta automaticamente gli elementi superiori se esistono.
 
<code>
'nota: Indice è il numero dell'elemento da cancellare, passato alla funzione come parametro 
miaAgenda[Indice].Remove
</code>


<h3>COLLECTION</h3>

La Collection è una rappresentazione dei dati estremamente potente, versatile e semplice in quanto si compone
di solo una coppia di informazioni:
 
- la KEY (chiave) di accesso: una stringa che deve avere un valore univoco e non nullo (se Null, l'elemento
'sparisce', ovvero viene eliminato).
 
- il VALUE (valore): può essere qualsiasi cosa (variabile semplice, array, oggetti e anche altre
Collection).
 
La Key può essere semplicemente un numero indice convertito in stringa per cui spesso l'uso delle Collection è
concettualmente simile all'uso degli Array.
 
La definizione e l'instanziamento di una Collection, che è un Oggetto, è del tutto uguale a quelle degli tipi di variabile,
per cui:
 
<code>
Pubblic miaAgenda as Collection 
... 
miaAgenda = New Collection 
</code>


<h4>Enumerazione ed accessi agli elementi</H4>

<code>
Dim cliente AS clsContatto 
Dim tel as String 
 
'Utilizzando il campio chiave (es. Codice Fiscale), si accede direttamente al singolo elemento: 
tel = miaAgenda[CodiceFiscale].Telefono 'Attenzione: la chiave deve essere una stringa! 
 
L'enumerazione degli elementi utilizza la notazione For Each come per tutti gli altri oggetti.
 

For Each cliente In miaAgenda 
Print cliente.Nome 
.... 
Next 
</code>


<h4>Inserimento di elementi</H4>

Occorre innanzitutto definire una nuova chiave; supponiamo di usare per questo il campo Telefono (certamente univoco).
 
Potrebbe però essere anche un valore esterno alla classe clsContatto, come un numero progressivo.
 
<code>
Static IdCount As Integer 
Dim nuovoContatto As clsContatto 
 
IdCount = IdCount + 1 

nuovoContatto as New clsContatto 
nuovoContatto.Nome = "Pippo" 
nuovoContatto.Telefono = 345-987654 
miaAgenda.Add(nuovoContatto, CStr(IdCount)) 'notare l'uso di IdCount come chiave 
</code>


<h4>Cancellazione elementi</H4>

Come anticipato, per cancellare un elemento è sufficiente porre a Null la chiave, oppure utilizzare anche qui il metodo 'Remove':
 
<code>
miaAgenda[IdCount]=Null 
'oppure: 
miaAgenda[IdCount].Remove 
</code>
In realtà, è altamente consigliabile verificare prima che la chiave esista, per esempio:
<code>
If miaAgenda[IdCount].Exist Then miaAgenda[IdCount].Remove 
</code>
E' importante notare come nel caso delle Collection non sia necessario ridimensionare la struttura in quanto si adegua da
sè.


<H3>SCHEMA DI IMPLEMENTAZIONE DI CLASSI E COLLECTION</H3>

Per riassumere quanto vito nel caso di utilizzo di classi e collection (strategia suggerita), viene di seguito riportato
uno schema sintetico dei documenti e delle dichiarazioni necessarie.

<table border=1>
<tr>
<th>Documento</th>
<th>Dichiarazioni</th>
</tr>
<tr>
<td>Form Main</td>
<td>Chiamate ai metodi clsAgenda.miaAgenda[chiave]...</td>
<tr>
<td>Classe 'clsAgenda'</td>
<td>
PUBLIC miaAgenda As Collection 
... 
PUBLIC Sub _New() 
miaAgenda = New Collection 
End 
 
PUBLIC Sub AddContatto(nome As String,telefono As String) 
... 
End 
 
PUBLIC Sub RemoveContatto(ID as integer) 
... 
End 
 
PUBLIC Sub GetContatto(ID as integer) 
... 
End 

</td>
</tr>
<tr>
<td>Classe 'clsContatto'</td>

<td>
PROPERTY Nome As String 
PROPERTY Telefono As String 
 
PRIVATE $iID As Integer 'proprietà utilizzata internamente per generare una nuova chiave 
PRIVATE $sNome As String 
PRIVATE $iTelefono As String 
</td>
<tr>
</table>
 

<H3>CONFRONTO</H3>

Sia gli array di strutture che le collection di classi sono per Gambas degli oggetti, per cui l'approccio è sotto molti
punti di vista simile.
 
Per chi proviene da VB le Strutture sono forse più familiari e forse più semplici da utilizzare dalle Classi.
Occorre però anche considerare la diversa modalità di creazione e aggiunta di elementi in Gambas rispetto a VB, che
'appesantisce' in una certa misura la gestione.
 
Le Classi da parte loro hanno numerosi vantaggi in termini di leggibilità e di manutenzione del codice, nonchè offrono
capacità di estensione d'uso sconosciute alle Strutture.
Basti pensare all'ereditarietà delle Classi per cui si può avere una classe base e numerose classi figlie, senza dovere
ripetere tutto il codice, e racchiudere il tutto in una Collection.
 
Inoltre, e questo è fondamentale per la sicurezza verso bachi e modifiche del codice nella Main, le classi consentono
l'incapsulamento del codice, delegando tutte le procedure di accesso e verifica di congruità dei dati alla classe stessa.
Questo permette tra l'altro di riutilizzare la stessa classe in altri progetti.
 
Dal punto di vista prestazionale, la valutazione sui tempi di esecuzione è delegata ad una seconda parte di questo
documento che sarà rilasciata al più presto,
insieme ad un programma di esempio e di test.


--[[Utente:Orionis|Orionis]] ([[Discussioni utente:Orionis|discussioni]]) 08:11, 30 giu 2014 (MDT)

Confronto Array di Strutture verso Collezione di Classi

2014-06-30T14:21:05Z

Orionis:

<h2>Confronto Array di Strutture verso Collezione di Classi</h2>

Per chi proviene in Gambas da MS VB la definizione e la gestione di strutture dati personalizzate può essere fonte di
confusione.
In genere, l'utente medio VB è abituato ad utilizzare array di strutture ('custom types').
 
Altri preferiscono utilizzare le Classi, con relative proprietà e metodi, e le Collection; in questo caso l'approccio a
Gambas non comporta variazioni sostanziali.
 
La differenza sostanziale tra Array e Collection è data dalla differente metodologia di accesso agli elementi. 
Gli Array sono per loro natura 'posizionali', ovvero la posizione in memoria è sequenziale e stabilita dalla dimensione e
dall'indice progressivo del singolo elemento.
 
Le Collection sono gestite autonomamente dal compilatore e la posizione degli elementi non è determinata; l'accesso avviene
tramite un indice chiave ('Key').
 
Lo scopo di questo documento è di fornire alcune informazioni sulle differenze tra i due approcci, con vantaggi e svantaggi,
e una sintetica valutazione prestazionale.
 
Per ciascun approccio saranno presentate le 3 operazioni fondamentali di gestione liste, ovvero Accesso, Aggiunta,
Eliminazione.


<h3>Definizione di STRUTTURE</h3>

Per gli esempi che seguino consideremo una semplicissima struttura dati composta da due proprietà, definita in Gambas con:
 
<code>
PUBLIC STRUCT Contatto 
ID As Integer
nome As String 
telefono As String 
END STRUCT
</code>


<h3>Definizione di CLASSI</h3>

L'uso di classi comporta la consueta creazione di un documento di classe (es. clsContatto) che esponga le stesse
proprietà viste sopra e dei metodi per la gestione delle stesse.
Si crea dunque il nuovo documento 'clsContatto' (Attenzione: deve avere la definizione all'inizio <code>CREATE
STATIC</code>).
 
<code>
'Class clsContatto 
CREATE STATIC 
PROPERTY Nome As String 
PROPERTY Telefono As String 
 
PRIVATE $iID As Integer 'proprietà utilizzata internamente per generare una nuova chiave 
PRIVATE $sNome As String 
PRIVATE $iTelefono As String 
</code>
 
E' consigliabile usare questo approccio che prevede di 'nascondere' le proprietà interne della classe ed accedere ad esse
solo tramite chiamate ai metodi pubblici esposti.
In questo modo, oltre alla maggiore flessibilità di modifica della classa, si delega alla classe il compiti di validazione
dei parametri.


 

<h3>ARRAY</h3>


In Gambas gli array di strutture possono essere statici o dinamici, ovvero a dimensioni prestabilite oppure variabili.


<h4>Array statici</H4>

Gli Array statici sono di scarso interesse in quanto la loro dimensione è 'hard coded' nel sorgente, quindi sono per
niente flessibili. Ciò che segue è quindi sono allo scopo di completezza d'informazione e non sarà utilizzato negli esempi.
 
NOTA: in VB non esiste il concetto di Array statico in quanto può essere in qualsiasi momento ridimensionato con le
istruzioni REDIM [PRESERVE}
 
La dichiarazione di un array statico di 10 strutture Contatto si scrive: 
<code>PUBLIC miaAgenda[10] as STRUCT Contatto</code>


<h4>Array dinamici</H4>

La dichiarazione di Array dinamici è sottilmente, ma sostanzialmente, diversa:
 
<code>PUBLIC miaAgenda as NEW Contatto[]</code>
 
Si noti l'ovvia assenza del numero di elementi, l'uso di NEW e la diversa posizione delle parentesi quadre.
 
NOTA 1: per Gambas gli Array dinamici non sono altro che degli oggetti (classi), per cui valgono proprietà e metodi
ereditati dalla classe madre 'Object'.
 
Ne consegue che l'utilizzo come Array piuttosto che come classi è più una scelta dell'utilizzatore che pratica, tranne
nell'enumerazione degli elementi.
 
NOTA 2: se si vuole utilizzare un Modulo esterno al Form principale (per pulizia del codice) per la gestione dei
dati, è obbligatorio copiare esattamente la dichiarazione della struttura ANCHE nel Form. 
 
Per ridimensionate l'array (in VB si scriverebbe <code>Redim Preserve miaAgenda(11)</code>); in Gambas occorre procedere in
3 fasi:
 
1. si aumenta la dimensione dell'array con: <code>miaAgenda.Resize(11)</code> 
2. si istanzia un nuovo elemento 'Contatto' con: <code>nuovoContatto as New Contatto</code> 
3. si aggiunge il nuovo elemento vuoto con: <code>miaAgenda.Add(nuovoContatto)</code> 
 

<h4>Enumerazione e accesso agli elementi</H4>

Accedere a tutti (enumerazione) o ad un elemento dell'Array è identico al metodo usato in VB, con l'unica avvertenza di
usare le parentesi quadre invece che tonde, per cui:
 
<code>
Dim cliente AS Contatto 
Dim numero AS String 
Dim k as Integer 
 
'per recuperare il valore di un campo dal record n°5: 
numero = miaAgenda[5].telefono 
 
'per recuperare l'intero record dall'agenda: 
For k=1 To miaAgenda.Count 
cliente = miaAgenda[k] 
.... 
Next 
</code>


<h4>Inserimento di elementi</H4>

Si incrementa come prima cosa la dimensione dell'array, come già visto, e poi si procede ad aggiungere i nuovi valori:
 
<code>
Static IdCount As Integer 
Dim nuovoContatto As Contatto 
 
IdCount = IdCount + 1 
miaAgenda.Resize(miaAgenda.Count+1) 
nuovoContatto as New Contatto 
nuovoContatto.ID = IdCount
nuovoContatto.Nome = "Pippo" 
nuovoContatto.Telefono = 333-123456 
miaAgenda.Add(nuovoContatto) 
</code>


<h4>Cancellazione elementi</H4>

In VB l'eliminazione di un elemento richiede lo spostamento di tutti gli elementi superiori a quello voluto e
successivamente il ridimensionamento dell'array. Gambas mette invece a disposizione il metodo Remove che elimina
l'elemento e sposta automaticamente gli elementi superiori se esistono.
 
<code>
'nota: Indice è il numero dell'elemento da cancellare, passato alla funzione come parametro 
miaAgenda[Indice].Remove
</code>


<h3>COLLECTION</h3>

La Collection è una rappresentazione dei dati estremamente potente, versatile e semplice in quanto si compone
di solo una coppia di informazioni:
 
- la KEY (chiave) di accesso: una stringa che deve avere un valore univoco e non nullo (se Null, l'elemento
'sparisce', ovvero viene eliminato).
 
- il VALUE (valore): può essere qualsiasi cosa (variabile semplice, array, oggetti e anche altre
Collection).
 
La Key può essere semplicemente un numero indice convertito in stringa per cui spesso l'uso delle Collection è
concettualmente simile all'uso degli Array.
 
La definizione e l'instanziamento di una Collection, che è un Oggetto, è del tutto uguale a quelle degli tipi di variabile,
per cui:
 
<code>
Pubblic miaAgenda as Collection 
... 
miaAgenda = New Collection 
</code>


<h4>Enumerazione ed accessi agli elementi</H4>

<code>
Dim cliente AS clsContatto 
Dim tel as String 
 
'Utilizzando il campio chiave (es. Codice Fiscale), si accede direttamente al singolo elemento: 
tel = miaAgenda[CodiceFiscale].Telefono 'Attenzione: la chiave deve essere una stringa! 
 
L'enumerazione degli elementi utilizza la notazione For Each come per tutti gli altri oggetti.
 

For Each cliente In miaAgenda 
Print cliente.Nome 
.... 
Next 
</code>


<h4>Inserimento di elementi</H4>

Occorre innanzitutto definire una nuova chiave; supponiamo di usare per questo il campo Telefono (certamente univoco).
 
Potrebbe però essere anche un valore esterno alla classe clsContatto, come un numero progressivo.
 
<code>
Static IdCount As Integer 
Dim nuovoContatto As clsContatto 
 
IdCount = IdCount + 1 

nuovoContatto as New clsContatto 
nuovoContatto.Nome = "Pippo" 
nuovoContatto.Telefono = 345-987654 
miaAgenda.Add(nuovoContatto, CStr(IdCount)) 'notare l'uso di IdCount come chiave 
</code>


<h4>Cancellazione elementi</H4>

Come anticipato, per cancellare un elemento è sufficiente porre a Null la chiave, oppure utilizzare anche qui il metodo 'Remove':
 
<code>
miaAgenda[IdCount]=Null 
'oppure: 
miaAgenda[IdCount].Remove 
</code>
In realtà, è altamente consigliabile verificare prima che la chiave esista, per esempio:
<code>
If miaAgenda[IdCount].Exist Then miaAgenda[IdCount].Remove 
</code>
E' importante notare come nel caso delle Collection non sia necessario ridimensionare la struttura in quanto si adegua da
sè.


<H3>SCHEMA DI IMPLEMENTAZIONE DI CLASSI E COLLECTION</H3>

Per riassumere quanto vito nel caso di utilizzo di classi e collection (strategia suggerita), viene di seguito riportato
uno schema sintetico dei documenti e delle dichiarazioni necessarie.

<table border=1>
<tr>
<th>Documento</th>
<th>Dichiarazioni</th>
</tr>
<tr>
<td>Form Main</td>
<td>Chiamate ai metodi clsAgenda.miaAgenda[chiave]...</td>
<tr>
<td>Classe 'clsAgenda'</td>
<td>
PUBLIC miaAgenda As Collection 
... 
PUBLIC Sub _New() 
miaAgenda = New Collection 
End 
 
PUBLIC Sub AddContatto(nome As String,telefono As String) 
... 
End 
 
PUBLIC Sub RemoveContatto(ID as integer) 
... 
End 
 
PUBLIC Sub GetContatto(ID as integer) 
... 
End 

</td>
</tr>
<tr>
<td>Classe 'clsContatto'</td>

<td>
PROPERTY Nome As String 
PROPERTY Telefono As String 
 
PRIVATE $iID As Integer 'proprietà utilizzata internamente per generare una nuova chiave 
PRIVATE $sNome As String 
PRIVATE $iTelefono As String 
</td>
<tr>
</table>
 

<H3>CONFRONTO</H3>

Sia gli array di strutture che le collection di classi sono per Gambas degli oggetti, per cui l'approccio è sotto molti
punti di vista simile.
 
Per chi proviene da VB le Strutture sono forse più familiari e forse più semplici da utilizzare dalle Classi.
Occorre però anche considerare la diversa modalità di creazione e aggiunta di elementi in Gambas rispetto a VB, che
'appesantisce' in una certa misura la gestione.
 
Le Classi da parte loro hanno numerosi vantaggi in termini di leggibilità e di manutenzione del codice, nonchè offrono
capacità di estensione d'uso sconosciute alle Strutture.
Basti pensare all'ereditarietà delle Classi per cui si può avere una classe base e numerose classi figlie, senza dovere
ripetere tutto il codice, e racchiudere il tutto in una Collection.
 
Inoltre, e questo è fondamentale per la sicurezza verso bachi e modifiche del codice nella Main, le classi consentono
l'incapsulamento del codice, delegando tutte le procedure di accesso e verifica di congruità dei dati alla classe stessa.
Questo permette tra l'altro di riutilizzare la stessa classe in altri progetti.
 
Dal punto di vista prestazionale, la valutazione sui tempi di esecuzione è delegata ad una seconda parte di questo
documento che sarà rilasciata al più presto,
insieme ad un programma di esempio e di test.


[[Categorie:Guide_della_comunità|4]]
--[[Utente:Orionis|Orionis]] ([[Discussioni utente:Orionis|discussioni]]) 08:11, 30 giu 2014 (MDT)

Confronto Array di Strutture verso Collezione di Classi

2014-06-30T14:11:58Z

Orionis: Creata pagina con '<h2>Confronto Array di Strutture verso Collezione di Classi</h2> Per chi proviene in Gambas da MS VB la definizione e la gestione di strutture dati personalizzate può ess...'