DEFVIDPOS
La specifica '@DEFVIDPOS consente di eseguire il posizionamento su un determinato controllo di una videata, mediante l'indicazione dell'ID o del nome del controllo o della variabile associata.
Parametri
| Parametro | Definizione | I/O | Versione traduttore | SMP | |
|---|---|---|---|---|---|
| VAR | Variabile | ||||
| IDVIDEATA | Stringa | ||||
| IDPAGINA | Stringa | ||||
| PROPERTYID | Stringa | ||||
| ID | Stringa | ||||
| NODO | Stringa | ||||
| VID | Stringa | ||||
| CELLA | |||||
| PAG | Intero | ||||
| ERR | Stringa | ||||
| GOVID | Azione | ||||
| CANVID | Intero | ||||
| NOSEL | Intero | ||||
| ELEMENTOLISTBOX | Intero | ||||
| SELEDIT |
VAR
[<variabile-controllo>] Definisce la variabile che è associata al controllo su cui si intende assegnare il fuoco; questa variabile può riferire un controllo edit, griglia o albero. Nel caso in cui l'indicazione di posizionamento definisca un controllo disabilitato, per cui non è possibile eseguire il posizionamento, viene ricercato il primo controllo utile su cui posizionarsi. [<variabile-controllo>]: nome della variabile associata al controllo sul quale ci si vuole posizionare. .CELLA / .<Variabile cella> - (Input, Opzionale) [<riga>, <colonna>] Se indicato il parametro CELLA[] devono essere riportate le coordinate della cella della griglia su cui si intende attivare il fuoco; in alternativa invece del parametro CELLA[] è possibile indicare direttamente la variabile definita sulla cella; CELLA[] e <Variabile cella> sono alternativi. <riga-colonna>: numero di riga e di colonna. <variabile-cella>: nome della variabile associata alla cella sulla quale ci si vuole posizionare; l'opzione è alternativa all'indicazione CELLA[<riga>, <colonna>] ed ha il limite di lavorare sulla riga corrente. La variabile viene ricercata tra le variabili associate alle celle della riga corrente. <tabella> Attenzione alla sintassi. Se si indica il parametro CELLA[] oppure <Variabile cella> la sintassi prevede il carattere '.' (punto) come separatore tra la <Variabile controllo> ed il parametro. </tabella>
IDVIDEATA
Identificativo della videata.
L'utilizzo del parametro implica l'utilizzo del parametro IDPAGINA
IDPAGINA
Corrisponde all'identificativo della singola pagina definito sulla specifica @DEFVIDMPAGDYN/@DEFVIDMPAG. Utilizzato in coppia con l'IDVIDEATA permette di posizionarsi su una data pagina del multipagina.
L'utilizzo del parametro implica l'utilizzo del parametro IDVIDEATA
PROPERTYID
Si può utilizzare esclusivamente con la Griglia da collezione. È necessario associare il PropertyID di una determinata proprietà della collezione dati. Automaticamente, il posizionamento, verrà ribaltato sulla corrispettiva cella sulla griglia.
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.
NODO
Definisce il nodo dell'albero a cui assegnare il fuoco. Valido solo per Albero AVANZATO
L'utilizzo del parametro implica l'utilizzo del parametro ID
VID
[FlagCanvid] Definisce il valore che deve assumere la variabile CANVID prima del ritorno alla videata. Il parametro consente di fare in modo che al rientro nella videata questa venga rieseguita, e quindi siano eseguite anche le decodifiche dei campi (CANVID=1) oppure evitare che la videata sia completamente ridisegnata. Il parametro DEVE essere valorizzato =1 (uno) nei casi di videate composte e sincronizzate. [<FlagCanvid>]: può essere una costante numerica o una variabile di tipo intero, default =0 (zero).
CELLA
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.
PAG
[<numero pagina>] <numero-pagina>: È il numero identificativo della pagina di una videata multipagina su cui eseguire il posizionamento.
ERR
[<costante stringa>|<variabile stringa>|<concatenazione stringa>] Definisce il messaggio da visualizzare in ingresso alla videata; dopo la visualizzazione del messaggio viene attivato il fuoco sul controllo eventualmente indicato. Il parametro è opzionale, in quanto la specifica potrebbe essere utilizzata per definire solamente il posizionamento sulla videata. [<costante stringa>]: messaggio costante indicato fra doppi apici. [<variabile stringa>]: nome della variabile contenente il messaggio da visualizzare. [<concatenazione stringa>]: combinazione di costanti e variabili concatenate. E' possibile utilizzare variabili di tipo Blob (?) a patto che esse siano inserite all'interno della funzione MID$.
GOVID
[<azione goto>] Definisce un'azione da eseguire al termine dell'esecuzione della specifica. In particolare l'azione indica un GOTO ad una qualche label del programma in cui è presente la videata. Se il parametro GOTO[...] non è indicato, viene generata implicitamente un GOTO alla label che precede la videata. L'indicazione del parametro nella forma 'GOVID[]' consente al programmatore di gestire esplicitamente l'azione con una specifica successiva a '@DEFVIDPOS. [<azione goto>]: GOTO succeduto dal nome della label
CANVID
[FlagCanvid] Definisce il valore che deve assumere la variabile CANVID prima del ritorno alla videata. Il parametro consente di fare in modo che al rientro nella videata questa venga rieseguita, e quindi siano eseguite anche le decodifiche dei campi (CANVID=1) oppure evitare che la videata sia completamente ridisegnata. Il parametro DEVE essere valorizzato =1 (uno) nei casi di videate composte e sincronizzate. [<FlagCanvid>]: può essere una costante numerica o una variabile di tipo intero, default =0 (zero).
NOSEL
[FlagNoSel] Se indicato, impedisce che quando il campo di edit acquisisce il fuoco venga selezionato il suo contenuto. [<FlagNoSel>]: può essere una costante numerica o una variabile di tipo intero. <tabella> Si sconsiglia l'utilizzo di questo parametro e di sostituirlo con il nuovo parametro SELEDIT[] </tabella>
ELEMENTOLISTBOX
Permette il posizionamento su uno specifico elemento della listbox.
SELEDIT
Permette di definire in quale posizione posizionare il cursore di un campo di edit (non html) e quanti caratteri selezionare.
Esempi
Esempio
'@DEFVID DIM[35,140] NOME[Videata] ID["IDVIDEATA"] TIT["Titolo Videata"] RIBBON[IDRIBBON["RIBBONBAR"]]
'@DEFRIBBONBAR NOME[RIBBON] IDRIBBONBAR["RIBBONBAR"] _
CATEGORIA[ID["Azioni"] TIT["AZIONI"] _
GRUPPO[ID["GRP1"] TIT["Navigazione"] _
BOTTONE[ID["SYS_EXIT"] AZIONE[Exit()]] _
BOTTONE[ID["SYS_EXIT_ESC"] AZIONE[Exit()] NASCOSTO[1]] _
BOTTONE[ID["BTN_SET_EDIT_POS"] AZIONE[SetEditPos()]] _
BOTTONE[ID["BTN_SET_GRID_POS_VAR"] AZIONE[SetGridPosVar()]] _
BOTTONE[ID["BTN_SET_GRID_POS_ROWCOL"] AZIONE[SetGridPosRowCol()]] _
BOTTONE[ID["BTN_SET_TREE_POS"] AZIONE[SetTreePos()]] _
] _
]
'@DEFGRIDPANEL NOME[GridPanel] ID["GridPanel"] _
RIGA[ALTEZZA[0.5] LAYOUT[#FISSO]] _
RIGA[ALTEZZA[34] LAYOUT[#FISSO]] _
RIGA[ALTEZZA[0.5] LAYOUT[#FISSO]] _
COLONNA[LUNGHEZZA[0.5] LAYOUT[#FISSO]] _
COLONNA[LUNGHEZZA[139] LAYOUT[#DINAMICO]] _
COLONNA[LUNGHEZZA[0.5] LAYOUT[#FISSO]]
'Controlli di videata
'@DEFEDIT VAR[ColumnVar] ID["EDIT_ID"] FMT[TESTO[10]] RET[1,1] POS[1,1] DIM[1,1] GRID[COL[2] RIGA[2] COLDIN[1] RIGADIN[1] ]
'@ENDGRIDPANEL NOME[GridPanel]
'@RUNVID
...
'@SRP SetEditPos()
'@DEFVIDPOS ID["EDIT_ID"] GOVID[]
Return
...
'@SRP SetGridPosVar()
'@DEFVIDPOS ID["GRID_ID"] CELLA[ColumnVar] GOVID[]
Return
...
'@SRP SetGridPosRowCol()
'@DEFVIDPOS ID["GRID_ID"] CELLA[NewRow, NewColumn] GOVID[]
Return
...
'@SRP SetTreePos()
'@DEFVIDPOS ID["ADVTREE_ID"] NODO["NODE_1_2"] GOVID[]
Return