Nello scorso capitolo abbiamo parlato dell’oggetto TextBox, elencandone tutte le proprietà, i metodi e gli eventi che sono stati scritti per l’oggetto stesso. Continuiamo questa guida con un nuovo oggetto: il Button

Il Button, dall’Inglese bottone, pulsante, è un oggetto molto importante nella creazione di applicazioni grafiche con Gambas. Esso infatti permette di eseguire una serie di istruzioni (chiamata procedura o routine) al verificarsi di un particolare evento. Ma l’evento più utilizzato per questo oggetto è senza dubbio l’evento Click, ovvero l’esecuzione delle istruzioni al click del bottone.

(continua…)

1. Drag: questo evento si verifica quando il button viene trascinato
2. Enter: questo evento si verifica quando il button viene cliccato
3. KeyPress: questo evento si verifica quando premiamo un tasto
4. KeyRelease: questo evento si verifica quando viene rilasciato un tasto
5. MouseDown: questo evento si verifica quando il mouse va verso il basso del button
6. MouseDrag: questo evento si verifica quando il mouse trascina il button
7. MouseMove: questo evento si verifica quando stiamo muovendo il mouse sul button
8. MouseUp: questo evento si verifica quando stiamo muovendo il mouse verso l’alto
9. MouseWheel: questo evento si verifica quando ruotiamo con la rotellina del mouse

1. Drag: questo metodo sposta il button
2. Delete: questo metodo cancella il button
3. Hide: questo metodo nasconde il button
4. Move: specificate le coordinate in intero, questo metodo muove dalla posizione originale alla posizione X,Y indicata.
5. Move_scaled: specificate le coordinate in float, questo metodo muove dalla posizione originale alla posizione X,Y indicata
6. Refresh: questo metodo aggiorna il contenuto del button
7. Reparent: cambia il contenitore del controllo
8. Resize: specificate le nuove dimesioni in intero, il metodo ridimensionerà il button.
9. ResizeScaled: specificate le nuove dimesioni in float, il metodo ridimensionerà il button
10. Show: questo metodo visualizza il button

1. Name: è il nome dell’oggetto. Questo nome deve essere univoco per tutti gli oggetti del progetto. Il nome servirà per riconoscere l’oggetto all’interno del codice.
2. Background: attraverso questa proprietà possiamo settare il colore di sfondo del controllo
3. Border: proprietà booleana. Impostare a vero se si desidera che il controllo abbia il bordo
4. Default: Rende l’oggetto un tasto predefinito alla pressione di ENTER
5. Drop: proprietà booleana. Indica se il controllo accetta o meno l’abbassamento.
6. Enabled: proprietà booleana. Indica se il button è abilitato (e quindi utilizzabile dagli utenti) oppure no.
7. Expand: proprietà booleana. Indica se il button si può espandere oppure no.
8. Font: se cliccato si aprirà una finestra da dove potremo indicare il tipo di font, il colore e la grandezza del carattere.
9. Foreground: indica il colore del primo piano.
10. Height: con questa proprietà settiamo l’altezza del button. Il numero dovrà essere un intero.
11. Ignore: proprietà booleana. Restituisce o imposta se un controllo deve essere ignorato quando il controllo madre organizza i suoi figli.
12. Mouse: Proprietà che indica il tipo di mouse che comparirà quando saremo sul button
13. Picture: imposta una immagine di sfondo per il controllo
14. Tag: le parole chiavi dell’oggetto per sapere a cosa l’abbiamo utilizzato.
15. Text: valore stringa. Indica il testo che comparirà sulla barra del titolo del button
16. Visbile: valore booleano. Se impostato a false il button non sarà visualizzato.
17. Widht: indica la lunghezza in pixel del button. Può essere solo un valore intero.
18. X: posizione all’avvio rispetto all’asse x (orizzontale) dello schermo e rispetto allla barra del titolo del button. Se 0 sarà il centro schermo
19. Y: posizione all’avvio rispetto all’asse y (verticale) dello schermo e rispetto alla barra del titolo del buttobn. Se 0 sarà il centro schermo.

Nello scorso capitolo abbiamo parlato dell’oggetto Label, elencandone tutte le proprietà, i metodi e gli eventi che sono stati scritti per l’oggetto stesso. Continuiamo questa guida con un nuovo oggetto: la TextBox

La TextBox, tradotto in inglese significa area di testo, rappresenta per appunto un’area di testo dove l’utente può scrivere. Grazie alle textbox iniziamo, così, a far interagire l’utente con il nostro programma, cosa che era al quanto limitata con label e form. Questo oggetto rappresenta uno dei principali oggetti di interazione con l’utente. Infatti gli oggetti che abbiamo visto fino ad oggi (Capitolo4: L’Oggetto Form – Capitolo5: L’oggetto Label) sono comunque utili nella stesura di un programma ma non sono stati creati per interagire con l’utente. Immaginiamo, ad esempio, di dover creare un programma che prenda in input un nome digitato, e restituisca “è bellissimo” se il nome è uguale a quello del creatore di questa guida (Alfonso Piscitelli nota). Come possiamo fare in modo che qualcuno digiti un nome? E’ impensabile, infatti, digitare il nome in un Form, oppure in una Label. (continua…)

1. Activate: quando la textbox viene attivata con un click
2. Change: questo evento si verifica quando il valore all’interno della textbox
3. DblClick: questo evento di verifica quando si fa doppio click sulla textboc
4. Drag: questo evento si verifica quando la textbox viene trascinata
5. Enter: questo evento si verifica quando la textbox viene cliccata
6. KeyPress: questo evento si verifica quando premiamo un tasto
7. KeyRelease: questo evento si verifica quando viene rilasciato un tasto
8. MouseDown: questo evento si verifica quando il mouse va verso il basso della textbox
9. MouseDrag: questo evento si verifica quando il mouse trascina la textbox
10. MouseMove: questo evento si verifica quando stiamo muovendo il mouse sulla texbox
11. MouseUp: questo evento si verifica quando stiamo muovendo il mouse verso l’alto
12. Mouse Wheel: questo evento si verifica quando ruotiamo con la rotellina del mouse

1. Clear: questo metodo cancella il contenuto di una textbox
2. Delete: questo metodo cancella la textbox
3. Drag: questo metodo sposta la textbox
4. Hide: questo metodo nasconde la textbox
5. Insert: inserisce un testo nella textbox. La sua sintassi è: textbox1.insert(“testo”)
6. Move: specificate le coordinate in intero, questo metodo muove dalla posizione originale alla posizione X,Y indicata.
7. Move_scaled: specificate le coordinate in float, questo metodo muove dalla posizione originale alla posizione X,Y indicata
8. Refresh: questo metodo aggiorna il contenuto della textbox
9. Reparent: cambia il contenitore del controllo
10. Resize: specificate le nuove dimesioni in intero, il metodo ridimensionerà la label.
11. ResizeScaled: specificate le nuove dimesioni in float, il metodo ridimensionerà la textbox.
12. Select: seleziona una parte di testo della textbox
13. SelectAll: seleziona tutto il testo di una textbox
14. Show: questo metodo visualizza la label
15. Unselect: deseleziona il contenuto selezionato in precedenza

1. Name: è il nome dell’oggetto. Questo nome deve essere univoco per tutti gli oggetti del progetto. Il nome servirà per riconoscere l’oggetto all’interno del codice.
2. Alignment: proprietà che definisce l’allineamento del testo nella label. Le opzioni disponibili sono:
   1. Center: allineamento centrato
   2. Left: allineamento verso destra
   3. Right: allineamento verso sinistra
   4. Normal: allineamento classico
3. Background: attraverso questa proprietà possiamo settare il colore di sfondo del controllo
4. Border: proprietà booleana. Impostare a vero se si desidera che il controllo abbia il bordo
5. Drop: proprietà booleana. Indica se il controllo accetta o meno l’abbassamento.
6. Enabled: proprietà booleana. Indica se la textbox è abilitato (e quindi utilizzabile dagli utenti) oppure no.
7. Expand: proprietà booleana. Indica se la textbox si può espandere oppure no.
8. Font: se cliccato si aprirà una finestra da dove potremo indicare il tipo di font, il colore e la grandezza del carattere.
9. Foreground: indica il colore del primo piano.
10. Height: con questa proprietà settiamo l’altezza della textbox. Il numero dovrà essere un intero.
11. Ignore: proprietà booleana. Restituisce o imposta se un controllo deve essere ignorato quando il controllo madre organizza i suoi figli.
12. Mouse: Proprietà che indica il tipo di mouse che comparirà quando saremo sulla textbox
13. Password: proprietà booleana. Se impostata a vero il testo verrà oscurato come se si stesse digitando una password
14. Tag: le parole chiavi dell’oggetto per sapere a cosa l’abbiamo utilizzato.
15. Text: valore stringa. Indica il testo che comparirà sulla barra del titolo della textbox
16. Visbile: valore booleano. Se impostato a false la textbox non sarà visualizzato.
17. Widht: indica la lunghezza in pixel della textbox. Può essere solo un valore intero.
18. X: posizione all’avvio rispetto all’asse x (orizzontale) dello schermo e rispetto allla barra del titolo della textbox. Se 0 sarà il centro schermo
19. Y: posizione all’avvio rispetto all’asse y (verticale) dello schermo e rispetto allla barra del titolo della textbox. Se 0 sarà il centro schermo.