La classe Action - Cronologia

Gianluigi il 10:19, 21 feb 2022

2022-02-21T10:19:38Z

← Versione meno recente		Versione delle 04:19, 21 feb 2022
Riga 59:		Riga 59:

	=Note=		=Note=
	[1] Vedere anche questa discussione: https://lists.gambas-basic.org/pipermail/user/~~2020~~-~~October~~/~~070206~~.html		[1] Vedere anche questa discussione: https://lists.gambas-basic.org/pipermail/user/2022-February/075454.html

Gianluigi il 16:52, 19 feb 2022

2022-02-19T16:52:01Z

← Versione meno recente		Versione delle 10:52, 19 feb 2022
Riga 4:		Riga 4:
	<BR>Possiede quattro metodi statici e otto proprietà.		<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.		Per prima cosa occorre sgombrare subito il campo da un grosso equivoco 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>.		<BR>Un sistema operativo con un desktop GTK tipo <I>Gnome</i> è in grado di far girare benissimo applicazioni <I>QT</i>.
	<BR><SPAN Style="text-decoration:underline">Gambas con QT funziona meglio e offre più stabilità</span>.		<BR><SPAN Style="text-decoration:underline">Gambas con le librerie QT normalmente 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>Prima di scrivere una sola riga di codice occorre imparare a 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>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>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.		<BR>Non fatelo, otterreste solo dei malfunzionamenti e tarderete di molto l'apprendimento del linguaggio.
			<BR>Solo dopo aver compreso a fondo come si disegnano le finestre in Gambas e aver preso dimestichezza con i vari contenitori, potrete disegnare le vs. finestre attraverso il codice.

	Per comprendere a fondo <B>Action</b> occorre capire bene come devono essere costruite le finestre.		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.		<BR>Una finestra Gambas ben progettata deve partire dai contenitori e con molta probabilità dal componente <B>gb.form.mdi</b> (<I>interfaccia multi documento</i>) che implementa la classe Action 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 (per intenderci tipo il form FMain di un nuovo progetto).

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

Vuott il 09:22, 11 gen 2021

2021-01-11T09:22:19Z

← Versione meno recente		Versione delle 03:22, 11 gen 2021
Riga 1:		Riga 1:
	(''pagina a cura del membro [http://www.gambas-it.org/smf/index.php?action=profile;u=1249 Gianluigi] del forum di Gambas-it.org'')		(''pagina a cura del membro [http://www.gambas-it.org/smf/index.php?action=profile;u=1249 Gianluigi] del forum di Gambas-it.org'') <SUP>[[[#Note\|Nota 1]]]</sup>

	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.		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.
Riga 55:		Riga 55:
	<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>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.		<BR>Stesso procedimento per tutte le altre proprietà e metodi supportati da Action.



			=Note=
			[1] Vedere anche questa discussione: https://lists.gambas-basic.org/pipermail/user/2020-October/070206.html

Vuott il 21:31, 18 gen 2019

2019-01-18T21:31:56Z

← Versione meno recente		Versione delle 15:31, 18 gen 2019
Riga 20:		Riga 20:

	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.		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:		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>Annulla</i> e il pulsante <I>Annulla</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		Public Sub Action_Activate(sKey As String) As Boolean
	Select Case sKey		Select Case sKey

Vuott il 13:31, 29 nov 2018

2018-11-29T13:31:28Z

← Versione meno recente		Versione delle 07:31, 29 nov 2018
Riga 33:		Riga 33:
	...		...
	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:		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>cliccare sulla combinazione da cambiare nella colonna ''Shortcut'' cancellare la voce agendo sul pulsantino, quindi agire sui tasti della nuova combinazione.		<BR>cliccare sulla combinazione da cambiare nella colonna ''Shortcut'', cancellare la voce agendo sul pulsantino, quindi agire sui tasti della nuova combinazione.
	Oppure:		Oppure:
	<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>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>.

Vuott il 13:30, 29 nov 2018

2018-11-29T13:30:45Z

← Versione meno recente		Versione delle 07:30, 29 nov 2018
Riga 33:		Riga 33:
	...		...
	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:		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>cliccare sulla combinazione da cambiare nella colonna ''Shortcut'' cancellare la voce agendo sul pulsantino, quindi agire sui tasti della nuova combinazione.
			Oppure:
			<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>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>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.

Vuott il 20:57, 14 mag 2018

2018-05-14T20:57:33Z

← Versione meno recente		Versione delle 14:57, 14 mag 2018
Riga 1:		Riga 1:
	~~=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'')
	(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.		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.
Riga 7:		Riga 6:
	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.		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>.		<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><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>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>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.

Vuott: Creata pagina con "=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 line..."

2018-05-14T20:56:22Z

Creata pagina con "=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 line..."

Nuova pagina

=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 Classe Action appartiene al componente gb.qt4 e consente di gestire le azioni definite nella Proprietà Action di molti controlli, è creabile e si comporta come un array statico di sola lettura.
 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 GTK debba creare applicazioni con quelle librerie, non è vero.
 Un sistema operativo con un desktop GTK tipo Gnome è in grado di far girare benissimo applicazioni QT.
Gambas con QT funziona meglio e offre più stabilità.
 L'altro equivoco è quello che in Gambas si possano "disegnare" finestre solo da codice.
 Ancor prima di scrivere una sola riga di codice occorre costruire le finestre del nostro progetto attraverso l'editor .form, l'Editor Menu e usando i contenitori, le barre dei pulsanti ecc.
 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.
 Non fatelo, otterreste solo dei malfunzionamenti e tarderete di molto l'apprendimento del linguaggio.

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

Nota: La IDE di Gambas è disegnata così.

Bene, fatta questa indispensabile premessa vediamo Action 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 Modifica con il sotto menu Ripristina e il pulsante Ripristina della barra, basterà assegnare alla proprietà Action di entrambi la stessa voce per esempio "undo" 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.
...
Action mette a disposizione tra gli altri il metodo statico Configure.
 Si può usare così avendo dato a menu e button l'action "shortcuts":
Case "shortcuts"
Action.Configure
...
Questo apre la finestra di dialogo Configure shortcuts che da modo all'utente di riconfigurare a proprio piacimento i tasti di scelta rapida; è la stessa finestra che usiamo nella IDE di Gambas e funziona alla stessa maniera:
 Si clicca sul pulsante Export, quello con la freccia verde rivolta verso il basso che salva nella nostra home un file di testo denominato <nome-programma>.shortcuts.
 Navighiamo fino al file di testo, lo variamo come ci pare e lo salviamo.
 Sempre dalla finestra Configure shortcuts clicchiamo sul pulsante Import, quello azzurro con la freccia rivolta verso l'alto, e il gioco è fatto.
 Da ora in poi il programma reagirà alle nuove impostazioni.
 La finestra Configure shortcuts mostra le icone, basta che ne sia assegnata almeno una delle due.
 Attenzione: Se abbiamo assegnato l'icona attraverso Action 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 (in alto, in basso, a destra e a sinistra).
 Action 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 Visible avessimo usato la proprietà Enabled.
 Ma possiamo fare anche prima usando un modello:
Action[".alin*", Me].Visible = True/False
Nota: 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.
 Attenzione: È l'assegnazione a Me che influenza Action, il punto davanti la voce indica a Gambas l'intenzione di localizzare l'azione, ma se non viene assegnato il parent l'azione sarà comunque globale, è il parent (Me in questo caso) 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.

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