Visualizza wikitesto di La classe Action

=La classe Action=
(pagina a cura del membro [http://www.gambas-it.org/smf/index.php?action=profile;u=1249 Gianluigi] del forum di Gambas-it.org)

Come recita la guida in linea di Gambas, la <I>Classe Action</i> appartiene al componente <I>gb.qt4</i> e consente di gestire le azioni definite nella <I>Proprietà Action</i> di molti controlli, è creabile e si comporta come un array statico di sola lettura.
<BR>Possiede quattro metodi statici e otto proprietà.

Per prima cosa occorre sgombrare subito il campo da due grossi equivoci e cioè che chi ha un desktop basato sulle librerie <I>GTK</i> debba creare applicazioni con quelle librerie, non è vero.
<BR>Un sistema operativo con un desktop GTK tipo <I>Gnome</i> è in grado di far girare benissimo applicazioni <I>QT</i>.
<SPAN Style="text-decoration:underline">Gambas con QT funziona meglio e offre più stabilità</span>.
<BR>L'altro equivoco è quello che in Gambas si possano <I>"disegnare"</i> finestre solo da codice.
<BR>Ancor prima di scrivere una sola riga di codice occorre costruire le finestre del nostro progetto attraverso l'editor <I>.form</i>, l'<I>Editor Menu</i> e usando i <I>contenitori</i>, le <I>barre dei pulsanti</i> ecc.
<BR>Chi viene da un'esperienza precedente di programmazione potrebbe aver difficoltà a capire e cercare di creare finestre attraverso il codice o tentarne una gestione grafica.
<BR>Non fatelo, otterreste solo dei malfunzionamenti e tarderete di molto l'apprendimento del linguaggio.

Per comprendere a fondo <B>Action</b> occorre capire bene come devono essere costruite le finestre.
<BR>Una finestra Gambas ben progettata deve partire dai contenitori e dal componente <B>gb.form.mdi</b> (<I>interfaccia multi documento</i>) che implementa la classe Action di gb.qt4 espandendola, attiva il componente <B>gb.Settings</b> e aggiunge due nuovi componenti; il controllo <B>ToolBar</b> (<I>barra dei pulsanti professionale</i>) e il controllo <B>Workspace</b> che permette di inglobare in un contenitore a schede finestre di primo livello.

<B>Nota</b>: La <I>IDE di Gambas</i> è disegnata così.

Bene, fatta questa indispensabile premessa vediamo <B>Action</b> più da vicino.

Una classica finestra Gambas si presenta con un menu e con una barra che normalmente mette a disposizione i pulsanti corrispondenti alle voci di menu con scorciatoie da tastiera.
Action permette di riunire sotto un'unica azione sia il pulsante che il menu corrispondente; per esempio se noi abbiamo un menu <I>Modifica</i> con il sotto menu <I>Ripristina</i> e il pulsante <I>Ripristina</i> della barra, basterà assegnare alla proprietà <B>Action</b> di entrambi la stessa voce per esempio <I>"undo"</i> e poi nella classe della form inserire il seguente codice:
  Public Sub Action_Activate(sKey As String) As Boolean
    Select Case sKey
      Case "undo"
         ' venendo azionato sia dal menu che dal pulsante, il codice qui fa qualcosa
         ' per ripristinare le cose allo stato precedente.
       ...
<B>Action</b> mette a disposizione tra gli altri il metodo statico <B>Configure</b>.
<BR>Si può usare così avendo dato a menu e button l'action <I>"shortcuts"</i>:
      Case "shortcuts"
        Action.Configure
      ...
Questo apre la finestra di dialogo <I>Configure shortcuts</i> che da modo all'utente di riconfigurare a proprio piacimento i tasti di scelta rapida; è la stessa finestra che usiamo nella <I>IDE di Gambas</i> e funziona alla stessa maniera:
<BR>Si clicca sul pulsante <B>Export</b>, quello con la freccia verde rivolta verso il basso che salva nella nostra home un file di testo denominato <I><nome-programma>.shortcuts</i>.
<BR>Navighiamo fino al file di testo, lo variamo come ci pare e lo salviamo.
<BR>Sempre dalla finestra <I>Configure shortcuts</i> clicchiamo sul pulsante <B>Import</b>, quello azzurro con la freccia rivolta verso l'alto, e il gioco è fatto.
<BR>Da ora in poi il programma reagirà alle nuove impostazioni.
<BR>La finestra <I>Configure shortcuts</i>  mostra le icone, basta che ne sia assegnata almeno una delle due.
<BR><B>Attenzione</b>: Se abbiamo assegnato l'icona attraverso <B>Action</b> nessuna icona verrà mostrata.

Ora supponiamo che il nostro programma preveda per alcune finestre inglobate, dei menu e dei pulsanti per l'allineamento del testo (<I>in alto, in basso, a destra e a sinistra</i>).
<BR><B>Action</b> ci permette di riunirli per assegnare loro alcune proprietà, per esempio:
 Action[".alin-alto,.alin-basso,.alin-destra,.alin-sinistra", Me].Visible = True/False
In questo modo noi possiamo ottenere la visibilità o meno sia dei pulsanti che dei menu in un colpo solo, oppure avremmo potuto renderli abili o inabili se invece di <I>Visible</i> avessimo usato la proprietà <I>Enabled</i>.
<BR>Ma possiamo fare anche prima usando un modello:
 Action[".alin*", Me].Visible = True/False
<B>Nota</b>: Il punto davanti alla voce di azione indica la localizzazione alla finestra corrente, altrimenti se altre finestre inglobate avessero le stesse voci di azione ne verrebbero influenzate.
<BR><B>Attenzione</b>: È l'assegnazione a <B>Me</b> che influenza <B>Action</b>, il <I>punto</i> davanti la voce indica a Gambas l'intenzione di localizzare l'azione, ma se non viene assegnato il <I>parent</i> l'azione sarà comunque globale, è il parent (<I>Me in questo caso</i>) l'osservatore dell'azione.
 Action["undo"].Picture = Picture["icon:/small/undo"]
In questo modo si assegna l'icona sia al pulsante che alla voce di menu.

<BR>Se abbiamo un gruppo di controlli che supportano la proprietà Tooltip (<I>ad esempio delle TextBox</i>) e fanno la stessa cosa possiamo raggrupparli in un'unica <B>Action</b> e assegnargli come abbiamo visto anche questa proprietà.
<BR>Stesso procedimento per tutte le altre proprietà e metodi supportati da Action.