DEFLABEL
La specifica '@DEFLABEL permette la definizione di una Label, ovvero un controllo che consiste in un' area rettangolare contenente un testo non modificabile da parte dell'utente.
Tale testo può invece essere variato da programma ed eventualmente reso invisibile.
La formattazione del testo viene effettuata mediante la definizione degli attributi FMT[] e STILE[].
Parametri
| Parametro | Definizione | I/O | Versione traduttore | SMP | |
|---|---|---|---|---|---|
| ID | Stringa | ||||
| VAR | Variabile | ||||
| POS | |||||
| DIM | |||||
| RET | |||||
| FMT | Stringa | ||||
| STILE | Stringa | ||||
| NASCOSTO | Condizione | ||||
| DISABILITATO | Condizione | ||||
| IPERTESTO | Intero | ||||
| TAGHTML | Intero | ||||
| AZIONELINK | |||||
| RIDIMENSIONABILE | |||||
| ETICHETTA | Stringa | ||||
| ANCORA | Stringa | ||||
| GRID | |||||
| STACK | |||||
| EXPANDER | |||||
| DOCK | |||||
| PERSONALIZZABILE | Intero | ||||
| LINKTO | |||||
| COMMENTO | Variabile | ||||
| BADGE | Variabile |
ID
Definisce la variabile o la costante di programma che contiene l'identificatore univoco del controllo.
Viene utilizzato dall'ambiente per gestire le personalizzazioni effettuate durante l'esecuzione del programma.
VAR
Attributo indicante il testo da visualizzare nel controllo.
Può essere una costante racchiusa tra doppi apici o una variabile di tipo stringa.
POS
Posizionamento del controllo.
Consente di indicare la riga e la colonna. Per entrambi è possibile specificare l'unità di misura.
POS[RigaVid [UnitàMisura], ColonnaVid [UnitàMisura]]
L'unità di misura può essere: 'C' per il posizionamento a caratteri e 'P' per il posizionamento in pixel. L'indicazione è opzionale, se omesso si assume 'C' come default.
DIM
Dimensione del controllo.
Consente di indicare l'altezza e la larghezza. Per entrambi è possibile specificare l'unità di misura.
DIM[Altezza [UnitàMisura], Larghezza [UnitàMisura]]
L'unità di misura può essere: 'C' per il posizionamento a caratteri e 'P' per il posizionamento in pixel. L'indicazione è opzionale, se omesso si assume 'C' come default.
RET
Coordinate della cella del reticolo da associare al controllo.
Queste informazioni hanno lo scopo di inserire il controllo nella logica di gestione degli spostamenti sulla videata.
FMT
Attributo di definizione del formato da applicare al testo della label
STILE
Permette di assegnare uno stile, precedentemente definito con la specifica '@DEFSTYLE, al testo della label.
La modifica, attraverso la creazione di un qualsiasi stile, dell'attributo di allineamento di un campo numerico in un controllo label resta senza effetto: per default il campo numerico è allineato a destra.
NASCOSTO
Parametro che consente di nascondere o visualizzare il controllo.
Se questo parametro non è presente il controllo risulta visibile di default.
È uguale alle espressioni presenti nei condizionamenti '@IFC/'@IFCO, ovvero è nella forma 'A operatore B' dove 'operatore' può essere '=, >, ≥, <, ≤, <>'.
All'interno dell'espressione è possibile utilizzare gli operatori 'AND' e 'OR' per generare istruzioni condizionali composte.
Se l'espressione risulta vera il controllo viene nascosto, in caso contrario viene visualizzato.
DISABILITATO
Determina se il controllo è abilitato o disabilitato.
Se la label è disabilitata, il testo suo assumerà un colore grigio scuro.
Contrariamente, se questo parametro non è presente, il controllo risulterà abilitato di default.
IPERTESTO
Attributo che consente alla label di assumere l'aspetto di un pulsante quando il mouse gli si posiziona sopra. Premendo una volta il controllo verrà riportato sull'edit avente il fuoco la parte di testo presente nella label che si trova a sinistra di uno dei seguenti caratteri: ' |\\!\'£$%&/()=?'^-_.:,;* > < '.
Premendo due volte il controllo oltre alle operazioni sopra indicate verrà forzata l'esecuzione del tasto F10.
Parametro con valori ammessi, si possono utilizzare i seguenti valori:
| Valore | Descrizione |
|---|---|
0 | Label normale |
1 | Label con l'aspetto di pulsante |
TAGHTML
Permette di indicare che il testo specificato dal parametro VAR utilizza tag HTML per la formattazione. La definizione dei tag HTML non è completamente compatibile con l'editor HTML, in particolare: il tag di definizione di un collegamento ipertestuale <a>, utilizza l'attributo msg. Sull'editor HTML, fermo restando valido l'utilizzo del tag <a> deve essere utilizzato l'attributo href. la visualizzazione degli stili titolo (h1, h2, ecc...) potrebbero non essere rappresentata allo stesso modo dalla '@DEFLABEL e dall'editor HTML I tag HTML correttamente riconosciuti ed interpretati sono: <tabella> Tag Descrizione Esempio <b> Testo in grassetto <b>testo in grassetto</b> <i> Testo in italico (corsivo) <i>testo in corsivo</i> <u> Testo sottolineato <u>testo sottolineato</u> <s> Testo barrato <s>testo barrato</s> <font> Definisce il font <hr> Inserisce una linea di separazione Testo prima<hr>testo dopo <br> Inserisce un "a capo" Testo prima<br>testo dopo <center> Testo centrato sulla riga <center>testo centrato</center> <left> Testo allineato a sinistra <left>Testo allineato a sinistra></left> <right> Testo allineato a destra <right>Testo allineato a destra</right> <justify> Testo giustificato <justify>Testo giustificato</justify> <h1> Imposta lo stile titolo 1 <h1>Titolo 1</h1> <h2> Imposta lo stile titolo 2 <h2>Titolo 2</h2> <h3> Imposta lo stile titolo 3 <h3>Titolo 3</h3> <h4> Imposta lo stile titolo 4 <h4>Titolo 4</h4> <h5> Imposta lo stile titolo 5 <h5>Titolo 5</h5> <h6> Imposta lo stile titolo 6 <h6>Titolo 6</h6> <table> Definizione di una tabella <table border="1"><tr><td>cella 1,1</td><td>cella 1,2</td></tr><tr><td>cella 2,1</td><td>cella 2,2</td></tr></table> <a> Definizione di iperlink Premi <a = msg="link1">qui</a> </tabella> FlagTestoHTML Constante o variabile numerica. I valori ammessi sono: 0 - il testo non contiene tag HTML 1 - il testo contiene tag HTML.
Parametro con valori ammessi, si possono utilizzare i seguenti valori:
| Valore | Descrizione |
|---|---|
0 | il testo non contiene tag HTML |
1 | il testo contiene tag HTML |
AZIONELINK
Permette di specificare la subroutine BC che verrà richiamata alla pressione di un collegamento ipertestuale presente nel testo HTML.Nella callback di gestione del collegamento ipertestuale è disponibile per consultazione la variabile d'ambiente ZVIDLINK$[60], valorizzata con il valore dell'attributo 'msg' del tag HTML <a> per la definizione del collegamento ipertestuale o, in mancanza di esso, con il valore dell'identificatore dell'etichetta. callbackAzioneLink: chiamata ad una '@SR del programma applicativo e ad eventuali istruzioni BC. La chiamata deve essere eseguita mediante l'istruzione 'GOSUB'. Non è possibile inserire in tale parametro le istruzioni 'GOTO' mentre è consentito inserire una o più operazioni semplici (assegnamenti) utilizzando il carattere ':' come separatore fra le istruzioni. IdMenu: deve essere racchiuso fra doppi apici se costante, altrimenti può essere una variabile alfanumerica. Rappresenta l'identificatore tramite il quale è stato definito il menu di contesto. Esempio - Definizione di una label con collegamento ipertestuale: <tabella> BC '@DEFLABEL VAR ['Per maggiori informazioni premi <a msg='+CHR$(34)+'link1'+CHR$(34)+'>qui</a>' TAGHTML[1] AZIONELINK[GOSUB GESTIONE_LINK] </tabella> L'esempio produce la visualizzazione del testo formattato come specificato. Alla pressione del link ipertestuale, l'ambiente attiva la sub BC GESTIONE_LINK. Prima del richiamo la variabile d'ambiente ZVIDLINK$ sarà impostata con il valore 'link1' (attributo msg del tag <a>).
RIDIMENSIONABILE
Parametro che specifica in che modo si vuole ridimensionare la griglia.
L'attributo viene considerato esclusivamente se la label è di tipo HTML.
ANCORA - (Input, Opzionale) Permette di ancorare la posizione del bottone ad un lato della finestra.
Parametro con valori ammessi, si possono utilizzare i seguenti valori:
| Valore | Descrizione |
|---|---|
TUTTO | L'oggetto si ridimensionerà sia verso destra che verso il basso |
DESTRA | L'oggetto si ridimensionerà solamente verso destra |
BASSO | L'oggetto si ridimensionerà solamente verso il basso |
NESSUNO | L'oggetto diventerà un oggetto NON ridimensionabile |
ETICHETTA
Individua l'eventuale etichetta da usare per la specifica '@RUNQUERY per etichettare il gruppo di record.
ANCORA
Permette di ancorare la posizione dell'immagine ad un lato della finestra, in modo che al ridimensionamento di questa la posizione relativa dell'immagine non cambi
Parametro con valori ammessi, si possono utilizzare i seguenti valori:
| Valore | Descrizione |
|---|---|
'DESTRA' | L'immagine è ancorata al lato destro della finestra |
'SOTTO' | L'immagine è ancorata al lato inferiore della finestra |
'SOTTODESTRA' | L'immagine è ancorata al lato inferiore e destro della finestra |
'DESTRACLIP' | L'immagine è ancorata al lato destro della finestra. Se la finestra è ridimensionata meno della dimensione iniziale, l'immagine rimane nella posizione iniziale prevista dal programma |
'SOTTOCLIP' | L'immagine è ancorata al lato inferiore della finestra. Se la finestra è ridimensionata meno della dimensione iniziale, l'immagine rimane nella posizione iniziale prevista dal programma |
'SOTTODESTRACLIP' | L'immagine è ancorata al lato inferiore e destro della finestra. Se la finestra è ridimensionata meno della dimensione iniziale, l'immagine rimane nella posizione iniziale prevista dal programma |
GRID
Attached Property per pannello di tipo Grid
EXPANDER
Attached Property per pannello di tipo Expander
DOCK
Consente di indicare se l'oggetto deve occupare tutto lo spazio del DockPanel in verticale e/o in orizzontale (possono essere indicati entrambi).
PERSONALIZZABILE
Definisce l'oggetto grafico come personalizzabile dall'utente in fase di runtime.
Parametro con valori ammessi, si possono utilizzare i seguenti valori:
| Valore | Descrizione |
|---|---|
0 | No |
1 | Si |
LINKTO
Permette di creare un legame tra due controlli esistenti all'interno della stessa videata.
COMMENTO
Attributo di definizione del tipo multilinea di commento da associare al campo. Il commento rimarrà visibile per il tempo in cui il mouse punterà sul campo interessato.
StringaCommento: costante racchiusa fra apici o una variabile di tipo stringa. Per far andare a capo il testo è necessaria la presenza del carattere di formattazione CHR$(13).
La stringa definita in questo paraetro può essere definita statica o dinamica.
È statica nel caso in cui il tag viene indicato.
Esempi
Funzionalità
DIM LabelVar[STRING]
DIM EditValue[STRING]
DIM Disabilita[TIPO[BCBOOL]]
'@DEFVID DIM[35,140] NOME[Videata] ID["IDVIDEATA"] TIT["Titolo Videata"]
'@DEFGRIDPANEL NOME[GridPanel] ID["GridPanel"] _
RIGA[ALTEZZA[0.5] LAYOUT[#FISSO]] _
RIGA[ALTEZZA[1] LAYOUT[#DINAMICO]] _
RIGA[ALTEZZA[1] LAYOUT[#DINAMICO]] _
RIGA[ALTEZZA[0.5] LAYOUT[#FISSO]] _
COLONNA[LUNGHEZZA[0.5] LAYOUT[#FISSO]] _
COLONNA[LUNGHEZZA[20] LAYOUT[#FISSO]] _
COLONNA[LUNGHEZZA[59.5] LAYOUT[#DINAMICO]] _
COLONNA[LUNGHEZZA[0.5] LAYOUT[#FISSO]]
'@DEFEDIT VAR[Disabilita] ID["CHECK_Disable"] CHECKBOX[1] POS[1,1] DIM[1,1] RET[1,1] _
GRID[RIGA[2] COL[3] COLDIN[1] RIGADIN[1]]
'@DEFLABEL VAR["Diabilita"] ID["LB_Disable"] _
POS[1,1] DIM[1,1] GRID[RIGA[2] COL[2] COLDIN[1]]
'Esempio uso LinkTo con un controllo di edit
'@DEFLABEL VAR[LabelVar] ID["LB_Testo"] _
LINKTO[ID["EDT_Testo"]] _
POS[1,1] DIM[1,1] STILE["ROSSO"] _
GRID[RIGA[3] COL[2] COLDIN[1]]
'@DEFEDIT VAR[EditValue] ID["EDT_Testo"] FMT[TESTO[20]] POS[1,1] DIM[1,1] RET[1,1] _
GRID[RIGA[3] COL[3] COLDIN[1] RIGADIN[1]] DISABILITATO[Disabilita=#True]
'@ENDGRIDPANEL NOME[GridPanel]
'@RUNVID
...
'@SRP Load()
'@DEFSTYLE STILE["ROSSO"] COLORETESTO[255, 0, 0]
Return