DEFFRAME
La specifica '@DEFFRAME permette la creazione di un oggetto grafico rettangolare, leggermente incassato, utilizzato per contenere altri controlli.
Parametri
| Parametro | Definizione | I/O | Versione traduttore | SMP | |
|---|---|---|---|---|---|
| ID | Stringa | ||||
| POS | |||||
| DIM | |||||
| TIPOFRAME | |||||
| STILE | Stringa | ||||
| NASCOSTO | Condizione | ||||
| GRID | |||||
| STACK | |||||
| EXPANDER | |||||
| DOCK | |||||
| PERSONALIZZABILE | Intero | ||||
| LINKTO |
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.
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.
TIPOFRAME
Consente di modificare l'aspetto grafico del controllo. Se viene omesso si assume come default 'INCASSATO'. StileFrame: è il parametro che definisce l'aspetto grafico del controllo. Può assumere i seguenti valori:
- PIATTO: il controllo è un semplice rettangolo con bordo nero.
- INCASSATO: il controllo è incassato rispetto alla Dialog.
- INRILIEVO:il controllo viene posto in rilievo rispetto alla Dialog. A questi 3 valori è possibile aggiungere, dopo uno spazio, la parola chiave BORDO3D che accentua l'aspetto tridimensionale del bordo.
Parametro con valori ammessi, si possono utilizzare i seguenti valori:
| Valore | Descrizione |
|---|---|
PIATTO | il controllo viene posto in rilievo rispetto alla Dialog |
INCASSATO | il controllo è incassato rispetto alla Dialog |
INRILIEVO | il controllo viene posto in rilievo rispetto alla Dialog |
STILE
Attributo di definizione dello stile da applicare al controllo.
Può essere una delle costanti definite in BC per gli stili oppure uno stile precedentemente definito tramite @DEFSTYLE.
NASCOSTO
Attributo che consente di nascondere e visualizzare il controllo. Quando il Frame è nascosto il suo contenuto rimane visibile. Se non è presente questo attributo il controllo risulta visibile. EspNascosto: espressione BC il cui valore logico determina la visualizzazione del controllo. È 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.
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
[FlagSiNo] Definisce l'oggetto grafico come personalizzabile dall'utente in fase di runtime.
Le Attached Property di un oggetto inserito all'interno di un pannello definiscono le modalità di visualizzazione dell'oggetto nel pannello e definiscono il comportamento da adottare quando sono modificate a run-time le dimensioni della videata (conseguentemente le dimensioni del pannello contenitore, conseguentemente quelle del controllo). Se l'oggetto viene definito all'interno di un pannello contenitore di tipo Grid è OBBLIGATORIO definire le sue Attached Property; se l'oggetto viene definito all'interno di un pannello di tipo Expander/Stack/Dock NON E' OBBLIGATORIO definire le sue Attached Property.
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.