DEFLINE
Definisce una linea a video.
Parametri
| Parametro | Definizione | I/O | Versione traduttore | SMP | |
|---|---|---|---|---|---|
| ID | Stringa | ||||
| POSINIZIO | |||||
| POSFINE | |||||
| STILE | Stringa | ||||
| POSPIXEL | Enumerazione | ||||
| RIDIMENSIONABILE | |||||
| 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.
POSINIZIO
Coordinate del primo vertice della linea. Il sistema di riferimento ha come origine il punto in alto a sinistra di coordinate (1,1) con l'asse verticale diretto verso il basso e quello orizzontale verso destra. Un incremento della prima coordinata implica uno spostamento verso il basso ed un incremento della seconda implica uno spostamento verso destra. RigaVid: numero (intero o decimale) indicante la quantità di spazio cui ci si deve spostare dal bordo superiore della videata. Questa quantità dipende dall'unità di misura utilizzata, ovvero dal parametro 'TipoCoord'. ColonnaVid: numero (intero o decimale) indicante la quantità di spazio di cui ci si deve spostare dal bordo destro della videata. Questa quantità dipende dall'unità di misura utilizzata, ovvero dal parametro 'TipoCoord'.
POSFINE
Coordinate del secondo vertice della linea. Il sistema di riferimento ha come origine il punto in alto a sinistra di coordinate (1,1) con l'asse verticale diretto verso il basso e quello orizzontale verso sinistra. Un incremento della prima coordinata implica uno spostamento verso il basso ed un incremento della seconda implica uno spostamento verso destra. RigaVid: numero (intero o decimale) indicante la quantità di spazio cui ci si deve spostare dal bordo superiore della videata. Questa quantità dipende dall'unità di misura utilizzata, ovvero dal parametro 'TipoCoord'. ColonnaVid: numero (intero o decimale) indicante la quantità di spazio di cui ci si deve spostare dal bordo destro della videata. Questa quantità dipende dall'unità di misura utilizzata, ovvero dal parametro 'TipoCoord'.
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.
gli attributi dello stile che hanno significato per la linea sono:
- TIPOBORDO[Tipo Bordo]: definisce se è una linea tridimensionale oppure semplice, se TIPOBORDO è 'semplice' è possibile specificare altre caratteristiche di disegno della linea mediante gli attributi dello stile TIPOBORDOGRAFICO e DIMBORDO, se TIPOBORDO è 'bassorilievo' verrà disegnata una linea tridimensionale con effetto incassato, se TIPOBORDO è 'altorilievo' verrà disegnata una linea tridimensionale con effetto 'in rilievo'.
- COLORETESTO[Colore testo]: definisce il colore della linea.
- TIPOBORDOGRAFICO[TipoBordoGrafico]: definisce il tipo di linea (continua, tratteggiata, ...), l'attributo è preso in esame se TIPOBORDO è 'semplice'.
- DIMBORDO[DimBordo]: spessore della linea, l'attributo è preso in esame se TIPOBORDO è 'semplice'.
POSPIXEL
Quando si usa come sistema di riferimento per la definizione delle coordinate video il 'carattere', non si specifica un punto ben preciso dello schermo (il pixel) ma piuttosto un'area rettangolare occupata dal singolo carattere a video. Le dimensioni tipiche sono 11(base) x 14(altezza). Questo parametro permette, nella definizione di una linea orizzontale oppure verticale, di indicare quale lato del rettangolo definito dalle coordinate specificate, usare per il disegno della linea. Ad esempio indicando per una linea le coordinate in carattere POSINIZIO(3,3) - POSFINE(3,10): si individuano due linee:
- se da programma si specifica l'attributo POSPIXEL [#SUPERIORE] verrà disegnata a video la linea nella posizione marcata in rosso nella figura;
- se da programma si specifica l'attributo POSPIXEL [#INFERIORE] verrà disegnata a video la linea nella posizione marcata in verde nella figura;
- se il parametro è omesso si assume come lato del rettangolo il INFERIORE per le lineee orizzontali e CENTRO per quelle verticali. Per le linee oblique (attualmente non gestite) l'attributo POSPIXEL non è considerato. Se le coordinate sono specificate in pixel, l'attributo POSPIXEL è ignorato. PosizionePixel I valori ammessi per PosizionePixel sono:
- #SUPERIORE: nel caso di linea orizzontale, la linea sarà allineata al bordo superiore del rettangolo individuato dalle coordinate.
- #INFERIORE: nel caso di linea orizzontale, la linea sarà allineata al bordo inferiore del rettangolo individuato dalle coordinate.
- #SINISTRO: nel caso di linea verticale, la linea sarà allineata al bordo inferiore del rettangolo individuato dalle coordinate.
- #DESTRO: nel caso di linea verticale, la linea sarà allineata al bordo inferiore del rettangolo individuato dalle coordinate.
- #CENTRO: nel caso di linea orizzontale, la linea sarà al centro dei bordi superiore ed inferiore del rettangolo individuato dalle coordinate; Nel caso di linea verticale, la linea sarà al centro dei bordi destro e sinistro del rettangolo individuato dalle coordinate. NASCOSTO[EspNascosto] Attributo che consente di nascondere la linea. EspNascosto: espressione BC il cui valore logico determina la visualizzazione del testo 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 testo viene nascosto, in caso contrario viene visualizzato. Se non è presente questo attributo il testo risulta visibile.
Parametro enumerato, può assumere i seguenti valori:
| Valore | Descrizione |
|---|---|
SUPERIORE | Nel caso di linea orizzontale, la linea sarà allineata al bordo superiore del rettangolo individuato dalle coordinate |
INFERIORE | Nel caso di linea orizzontale, la linea sarà allineata al bordo inferiore del rettangolo individuato dalle coordinate |
SINISTRO | Nel caso di linea verticale, la linea sarà allineata al bordo inferiore del rettangolo individuato dalle coordinate |
DESTRO | Nel caso di linea verticale, la linea sarà allineata al bordo inferiore del rettangolo individuato dalle coordinate |
CENTRO | Nel caso di linea orizzontale, la linea sarà al centro dei bordi superiore ed inferiore del rettangolo individuato dalle coordinate; Nel caso di linea verticale, la linea sarà al centro dei bordi destro e sinistro del rettangolo individuato dalle coordinate |
RIDIMENSIONABILE
[TipoDiRidimensionamento] Attributo che specifica in che modo si vuole ridimensionare la griglia.
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 |
NASCOSTO
Attributo che consente di nascondere il testo del controllo
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. Attached Property - (Input) - (Disponibile da BC/X v. 22.0) GRID[ COL[] RIGA[] COLSPAN[] RIGASPAN[] COLDIN[] RIGADIN[] ] oppure STACK[ [VERTICALE] [ORIZZONTALE] [ESTESO] ] oppure EXPANDER[ [VERTICALE] [ORIZZONTALE] [POSINFO] ] oppure DOCK[ [VERTICALE] [ORIZZONTALE]] 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
[ ID[IdentificativoControllo] PRINCIPALE[FlagSiNo] ] Permette di creare un legame tra due controlli esistenti all'interno della stessa videata.