DEFEXPANDERPANEL
Consente di definire un pannello con layout dinamico di tipo Expander.
Ha la funzione di contenitore per altri pannelli o per i controlli a video, la sua caratteristica è la possibilità di espanderlo per avere a video tutti i suoi componenti oppure di comprimerlo alle dimensioni di una label.
- Bisogna richiamare la specifica di chiusura @ENDEXPANDERPANEL.
- I metodi sono richiamabili nella callback specificata nel parametro ONLOAD della @DEFVID per le impostazioni della prima visualizzazione oppure in una qualsiasi azione per modificare le impostazioni in un secondo momento.
Parametri
| Parametro | Definizione | I/O | Versione traduttore | SMP | |
|---|---|---|---|---|---|
| NOME | Intero | ||||
| POS | |||||
| DIM | |||||
| DIMVAR | 27.6 | ||||
| MARGINI | |||||
| RET | |||||
| ID | Stringa | ||||
| TIT | Variabile | ||||
| STILE | Stringa | ||||
| STATO | Intero | ||||
| NASCOSTO | Condizione | ||||
| DISABILITATO | Condizione | ||||
| OUTPUT | Condizione | ||||
| DIMENSIONAMENTOAUTOMATICO | Intero | ||||
| DETTAGLIAGGIUNTIVI | Intero | ||||
| LAYOUTTIT | |||||
| GRID | |||||
| STACK | |||||
| EXPANDER | |||||
| DOCK | |||||
| PERSONALIZZABILE | Intero | ||||
| SPLITTER | Intero | ||||
| LINKTO | |||||
| ORIENTAMENTO | Enumerazione | ||||
| TOOLBAR | |||||
| AZIONE | |||||
| AZIONEINVIO |
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
Consente di definire le dimensioni del pannello.
Se il parametro DIM è omesso il dimensionamento coincide con la videata o il contenitore al cui interno stiamo inserendo il nuovo pannello, possiamo quindi definire un dimensionamento fisso oppure ereditarlo dal contenitore 'padre'.
DIMVAR
Consente di definire le dimensioni del pannello.
Se il parametro DIMVAR è omesso per il dimensionamento verrà utilizzato il parametro DIM.
MARGINI
Consente di definire un margine (padding) a sinistra e sopra (left e top) dei componenti inseriti al suo interno.
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.
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.
TIT
Consente di indicare il titolo del pannello.
Indicando tale parametro viene definita in testa al pannello una riga di intestazione con il testo al suo interno e imposta automaticamente il bordo sul pannello.
STATO
Consente di definire lo stato del pannello, da programma BC è possibile pilotare se impostare il pannello nello stato aperto o nello stato chiuso.
NASCOSTO
Permette di indicare la condizione per nascondere il controllo.
La condizione viene applicata solo in fase di creazione della videata (in contesto desktop).
DISABILITATO
Permette di indicare la condizione per disabilitare il controllo.
OUTPUT
Permette di indicare la condizione per rendere in output il controllo.
DIMENSIONAMENTOAUTOMATICO
Permette di accorpare il contenitore in base alla dimensione di righe e colonne visibili.
Parametro con valori ammessi, si possono utilizzare i seguenti valori:
| Valore | Descrizione |
|---|---|
0 | No |
1 | Si |
DETTAGLIAGGIUNTIVI
Consente di visualizzare il pulsante 'Visualizza dettagli aggiuntivi' all'interno del pannello.
Lo stato del pulsante comanderà la visualizzazione delle righe (non è abilitabile per le colonne) di dettaglio del GridPanel figlio.
Il parametro DETTAGLIAGGIUNTIVI, può essere utilizzato esclusivamente con la seguente struttura logica: '@DEFSTACKPANEL ORIENTAMENTO[#VERTICALE]... '@DEFEXPANDERPANEL DETTAGLIAGGIUNTIVI[1] '@DEFGRIDPANEL ..... COLONNA[ .. ] _ COLONNA[ .. ] _ RIGA[ .. DETTAGLIO[1] ] _ RIGA[ .. ] _ '@ENDEXPANDERPANEL '@ENDSTACKPANEL
Parametro con valori ammessi, si possono utilizzare i seguenti valori:
| Valore | Descrizione |
|---|---|
0 | No |
1 | Si |
LAYOUTTIT
Consente di definire lo stile da applicare al titolo del layout dinamico.
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
Consente di definire 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 |
SPLITTER
Permette di definire lo splitter all'interno del pannello, graficamente è una sottile banda più chiara con 6 punti disegnati al centro.
Lo splitter è una estensione del panello e permette a runtime di modificare la dimensione del pannello.
Parametro con valori ammessi, si possono utilizzare i seguenti valori:
| Valore | Descrizione |
|---|---|
0 | No |
1 | Si |
LINKTO
Consente di creare un legame tra due controlli esistenti all'interno della stessa videata.
ORIENTAMENTO
Consente di definire l'orientamento con cui inserire al suo interno i contenuti, i contenuti vengono impilati seguendo l'orientamento definito dal programma BC.
Parametro enumerato, può assumere i seguenti valori:
| Valore | Descrizione |
|---|---|
ORIZZONTALE | Orientamento orizzontale |
VERTICALE | Orientamento verticale |
TOOLBAR
Consente di definire una toolbar di azioni gestite da programma.
AZIONE
Consente di definire l'azione da eseguire al cambio dello stato del pannello eseguito sul client.
AZIONEINVIO
Permette di definire l'identificativo di un controllo, dal quale, prelevare l'azione ed eseguirla alla pressione del tasto INVIO.
L'utilizzo del parametro implica l'utilizzo del parametro ID
Metodi
| Metodo | Descrizione | SMP |
|---|---|---|
| Apri | Apre l'Expander | |
| Apri_Blocca | Apre l'Expander bloccando all'interazione dell'utente | |
| Chiudi | Chiude l'Expander | |
| Chiudi_Blocca | Chiude l'Expander bloccando all'interazione dell'utente | |
| Get_Stato | Restituisce lo stato del'expander | |
| Ridimensionamento | Ridimensiona automaticamente l'EXPANDERpanel (solo se all'interno di un wizard) | |
| Set_Immagine | Aggiorna immagine nel titolo del pannello | |
| Set_MenuLabel | Aggiorna la label associata al pannello per l'apertura del menu di contesto di riferimento | |
| Set_Sottotitolo | Aggiorna sottotitolo pannello | |
| Set_Titolo | Aggiorna titolo pannello |
Esempi
Definizione expander panel
'@DEFVID DIM[20,70] TIT["Videata"] ID["IDVideata"]
'@DEFGRIDPANEL NOME[Gridpanel] ID["IDGridPanel"] _
RIGA[ALTEZZA[19] LAYOUT[#DINAMICO]] _
RIGA[ALTEZZA[1] LAYOUT[#FISSO]] _
COLONNA[LUNGHEZZA[70] LAYOUT[#DINAMICO]]
'@DEFSTACKPANEL NOME[StackPanel] ID["IDStack"] ORIENTAMENTO[#VERTICALE] GRID[COL[1] RIGA[1] RIGADIN[1] COLDIN[1]]
'Definizione Expander panel
'@DEFEXPANDERPANEL NOME[ExpanderPanel] ID["IDExpanderPanel"] STACK[ORIZZONTALE[1] ESTESO[1]]_
GRID[COL[1] RIGA[1] RIGADIN[1] COLDIN[1]] _
POS[1,1] DIM[1,5] RET[1,1] DETTAGLIAGGIUNTIVI[1]
'@DEFGRIDPANEL NOME[Gridpanel2] ID["IDGridPanel2"] EXPANDER[VERTICALE[1]] _
RIGA[ALTEZZA[1] LAYOUT[#FISSO]] _
RIGA[ALTEZZA[17] LAYOUT[#DINAMICO]] _
RIGA[ALTEZZA[1] LAYOUT[#FISSO] DETTAGLIO[1]] _
RIGA[ALTEZZA[1] LAYOUT[#FISSO]] _
COLONNA[LUNGHEZZA[70] LAYOUT[#DINAMICO]]
'Definizione label che sarà visualizzato all'interno dell'Expander panel
'@DEFLABEL ID["IDLabelDentroExpander"] VAR["Interno expander"] DIM[1,1] POS[1,1] _
GRID[COL[1] RIGA[2] RIGADIN[1] COLDIN[1]]
'Definizione label che sarà visualizzato all'interno dell'Expander panel come dettaglio aggiuntivo
'@DEFLABEL ID["IDLabelDetail"] VAR["Dettalio aggiuntivo"] DIM[1,1] POS[1,1] _
GRID[COL[1] RIGA[3] RIGADIN[1] COLDIN[1]]
'@ENDGRIDPANEL NOME[Gridpanel2]
'@ENDEXPANDERPANEL NOME[ExpanderPanel]
'@ENDSTACKPANEL NOME[StackPanel]
'Definiziona label visualizzato fuori dall'ExpanderPanel
'@DEFLABEL ID["IDLabelFuoriExpander"] VAR["Fuori expander"] DIM[1,1] POS[1,1] _
GRID[COL[1] RIGA[2] COLDIN[1]]
'@ENDGRIDPANEL NOME[Gridpanel]
'@RUNVID
'#ENDCRif
Return