DEFIMAGE
Consente di definire le informazioni di posizionamento, dimensione, ecc... dell'immagine, sia essa in un file, sia essa una risorsa da linkare nell'eseguibile (.EXE o .DLL), che si vuole inserire nella videata.
L'immagine indicata verrà visualizzata all'interno di un rettangolo con un bordo tridimensionale (simile a quello dei campi di input).
Parametri
| Parametro | Definizione | I/O | Versione traduttore | SMP | |
|---|---|---|---|---|---|
| ID | Stringa | ||||
| IMAGE | Variabile | ||||
| VARENUMERATO | Variabile | 27.4 | |||
| BASE64IMAGE | Variabile | 32.1 | |||
| GRAPH | Long | ||||
| DISPOSIZIONE | Enumerazione | ||||
| POS | |||||
| DIM | |||||
| STILE | Stringa | ||||
| NASCOSTO | Condizione | ||||
| COMMENTO | Variabile | ||||
| ANCORA | Stringa | ||||
| DISABILITATO | Condizione | ||||
| AZIONE | |||||
| GRID | |||||
| STACK | |||||
| EXPANDER | |||||
| DOCK | |||||
| PERSONALIZZABILE | Intero | ||||
| LINKTO | |||||
| 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.
IMAGE
Specifica il nome del file contenente l'immagine o la risorsa immagine da visualizzare.
VARENUMERATO
Variabile enumerata da cui ottenere l'immagine associata al valore.
Se indicato tale parametro non va indicato il parametro IMAGE.
BASE64IMAGE
Specifica la variabile contenente l'immagine in formato Base64 da visualizzare.
GRAPH
Specifica il nome del grafico da visualizzare come immagine.
- L'indicazione di questo attributo esclude l'indicazione dell'immagine IMAGE[...].
- L'identificatore del grafico da utilizzare deve essere definito mediante @DEFGRAPH.
DISPOSIZIONE
Determina il posizionamento dell'immagine all'interno della cella destinata a contenerla.
Il parametro DISPOSIZIONE è opzionale e se non viene specificato si assume per default la disposizione CENTRATA.
Parametro enumerato, può assumere i seguenti valori:
| Valore | Descrizione |
|---|---|
AUTOMATICA | L'immagine viene compressa e/o dilatata orizzontalmente e/o verticalmente, di modo che sia contenuta interamente nell'area specificata per essa. |
ASPETTOORIGINALE | L'immagine viene compressa se più grande (per uno dei due assi) dell'area assegnata, mantenendo l'aspetto originale. Se più piccola, l'immagine è centrata rispetto all'area assegnata. |
ALTOSINISTRA | L'angolo in alto a sinistra dell'immagine viene a coincidere con l'angolo in alto a sinistra dell'area destinata a contenerla. Nel caso in cui le dimensioni dell'immagine siano maggiori di quest'area, la porzione di immagine eccedente non sarà visualizzata. |
CENTRATA | L'immagine viene centrata, sia verticalmente che orizzontalmente, all'interno dell'area destinata a contenerla. Nel caso in cui le dimensioni dell'immagine siano maggiori di quest'area, il comportamento è quello relativo ad ALTOSINISTRA. |
POS
Posizionamento del controllo.
Consente di indicare la riga e la colonna. Per entrambi è possibile specificare l'unità di misura.
- La sintassi è 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.
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 il controllo.
COMMENTO
Commento da associare alla cella.
Il contenuto del commento viene visualizzato come tooltip quando ci si posiziona con il mouse sulla cella/immagine.
Il valore del commento indicato su questo parametro ha priorità rispetto all'eventuale commento associato alla singola immagine indicata in VALORIAMMESSI/OPZIONE e può essere variato a fronte di ogni '@INSROWGRID.
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. |
DISABILITATO
Attributo di disabilitazione del controllo.
Se l'immagine non è abilitata sarà in 'grigetto', ovvero l'immagine sarà visibile in modo ridotto.
AZIONE
Definisce l'azione da eseguire quando l'immagine viene cliccata con il mouse.
GRID
Attached Property per pannello di tipo Grid.
EXPANDER
Attached Property per pannello di tipo Expander.
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.