DEFEDIT
Consente di definire le caratteristiche dell'edit.
Parametri
VAR
Nome della variabile da associare all'edit.
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.
VARVIDEO
Variabile a video applicativa, diversa dalla variabile di riferimento tecnica, utile per separare fisicamente il comportamento delle variabili per determinate esigenze applicative.
A video comanda e viene visualizzata la variabile applicativa definita nel parametro VARVIDEO[], mentre tutte le funzionalità interne mantengono il riferimento alla variabile tecnica. Se presente il parametro VARVIDEO[], la funzionalità di DECODVIDEO[] si baserà sul suo valore.
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.
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.
FMT
Formato della variabile associata all'edit.
SIMBOLOVALUTA
Attributo per definire il simbolo della valuta da visualizzare nell'edit prima dell'importo.
FMTVIDEO
Consente di definire il formato del testo visualizzato nella cella.
Questo parametro è obbligatorio per un testo variabile mentre può essere omesso nel caso di testo costante. In questo caso il formato sarà 'TESTO' ed il numero ci caratteri viene determinato direttamente dal testo.
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.
RIDIMENSIONABILE
Indica che il controlla possa venir ridimensionato in base alla dimensione della videata.
Se l'edit è multilinea il ridimensionamento avverrà sia sull'asse verticale che orizzontale; in caso contrario esclusivamente su quella orizzontale.
Parametro con valori ammessi, si possono utilizzare i seguenti valori:
| Valore | Descrizione |
|---|---|
0 | No |
1 | Si |
MULTILINEA
Consente di disegnare l'edit alto più righe.
INIVAL
Valore proposto la prima volta che viene visualizzato il controllo.
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.
PROTETTO
Consente di disabilitare il controllo ma lasciare abilitata l'esecuzione dei controlli e delle decodifiche.
PROTETTONASCOSTO
Consente di nascondere il controllo ma lasciare abilitata l'esecuzione dei controlli e delle decodifiche.
OUTPUT
Permette di indicare la condizione per rendere in output il controllo.
CONTROLLO
Tipo di controllo.
Parametro con valori ammessi, si possono utilizzare i seguenti valori:
| Valore | Descrizione |
|---|---|
D | Controllo su campo Data/Periodo. Viene eseguito un controllo per verificare che nel campo sia presente una data valida. Vuoto/Zero non ammesso |
d | Controllo su campo Data/Periodo. Viene eseguito un controllo per verificare che nel campo sia presente una data valida. Vuoto/Zero ammesso |
E | Controllo su campo Cartella/Archivio. Viene eseguito un controllo per verificare che nel campo sia presente un file/directory valida. Vuoto/Zero non ammesso |
e | Controllo su campo Cartella/Archivio. Viene eseguito un controllo per verificare che nel campo sia presente un file/directory valida. Vuoto/Zero ammesso |
T | Controllo su campo Ora. Viene eseguito un controllo per verificare che nel campo sia presente un'ora valida. Vuoto/Zero non ammesso |
t | Controllo su campo Ora. Viene eseguito un controllo per verificare che nel campo sia presente un'ora valida. Vuoto/Zero ammesso |
[ValMin]@[ValMax] | Si definisce un range di valori che deve assumere il campo per essere considerato corretto. ValMin: valore minimo che il campo deve assumere per essere considerato corretto. Nel caso in cui la variabile associata al campo sia di tipo alfanumerico, ValMin può essere una costante alfanumerica racchiusa tra doppi apici o una variabile. Se omesso si assume quale valore minimo il valore minimo inseribile nel campo. ValMax: valore massimo che il campo deve assumere per essere considerato corretto. Nel caso in cui la variabile associata nel campo sia di tipo alfanumerico, ValMax può essere una costante alfanumerica racchiusa tra doppi apici o una variabile. Se omesso si assume quale valore massimo il valore massimo inseribile nel campo |
'Stringa' | Controllo sul campo stringa. Se il campo ha lunghezza 1 carattere, viene eseguito il su descritto controllo mentre se ha lunghezza maggiore di 1 viene eseguito il controllo sul primo carattere del campo di input. Può essere utilizzato solo su campi di input di tipo alfanumerico |
OBBLIGATORIO
Consente di indicare l'obbligatorietà del campo.
DECOD
Consente di definire le azioni di decodifica.
POSTDERIVAZIONEDATI
Attributo di definizione dell'azione da eseguire al termine della DERIVAZIONEDATI e prima della DECODIFICA.
Al suo interno dovranno essere presenti esclusivamente azioni di aggiornamento videata.
CORRELATE
Consente di forzare la decodifica del controllo, a fronte di una modifica fatta su un edit correlato.
VARDECOD
Consente di definire una variabile per contenere il valore precedente della variabile associata all'edit.
NOERRNULL
Consente di effettuare anche la decodifica di un valore 'null', ovvero: 0 per i campi numerici e blank per i campi alfanumerici.
VALIDAZIONE
Permette di definire l'azione da eseguire quando il dato a video viene modificato manualmente dall'utente.
DECODVIDEO
Consente di definire l'azione da eseguire quando il dato a video viene modificato manualmente dall'utente.
RIC
Attributo di definizione della ricerca
Se l'edit è di formato <u>ARCHIVIO</u> o <u>CARTELLA</u>, la ricerca verrà sovrascritta con una ricerca base.
Per ovviare al problema usare il formato testuale.
HELP
Attributo di definizione del messaggio di Help, visualizzato quando la cella prende il fuoco.
COMMENTO
Consente di definire un tooltip multilinea da associare al campo.
Rimarrà visibile per il tempo in cui il mouse punterà sul campo interessato.
SUGGERIMENTO
Consente di visualizzare all'interno del campo di edit un suggerimento sul come o sul perché il campo deve essere compilato.
La stringa automatica non verrà mai restituita al programma BC e sparirà automaticamente appena il campo acquisirà il fuoco.
CHECKBOX
Consente di visualizzare il campo di edit come checkbox.
CALENDARIO
Consente di visualizzare il campo di edit come il calendario presente nei campi di tipo data.
COMBO
Consente di attivare la modalità di ricerca da opzioni.
ALTCOMBO
Dimensione che deve assumere la combo box di ricerca.
COLLEZIONECOMBO
Contiene i valori e le opzioni da visualizzare nella combo.
L'aggiornamento dei valori nella collezione, fa sì che vengano aggiornati i valori visualizzati nella combo.
L'utilizzo del parametro implica l'utilizzo del parametro COMBO
L'utilizzo del parametro esclude l'utilizzo dei parametri: ALTCOMBO, VAL, OPZIONE, VALS, OPZIONI
VAL
Attributo di definizione di uno dei valori che può assumere la variabile rappresentata nella Combo Box.
Se il parametro è omesso si desume che i valori siano contenuti direttamente nel successivo parametro OPZIONE, secondo la forma 'Valore Descrizione'. Per reperire il valore da assegnare alla variabile di ritorno verrà ricercato il primo spazio: ciò che è alla sinistra sarà il valore.
OPZIONE
Attributo di definizione della descrizione del valore indicato nel precedente parametro VAL[ ].
Nel caso in cui il precedente parametro VAL[] sia presente, il valore di ritorno sarà quello del parametro VAL corrispondente all'opzione selezionata. Nel caso, invece, in cui il parametro non sia presente, il valore si desume dall'opzione andando a ricercare il primo spazio: ciò che è alla sinistra sarà il valore.
VALS
Attributo di definizione dell'insieme di valori che può assumere la variabile rappresentata nella Combo Box.
Se il parametro è omesso si desume che i valori siano contenuti direttamente nel successivo parametro OPZIONI, secondo la forma 'Valore Descrizione'. Per reperire il valore da assegnare alla variabile di ritorno verrà ricercato il primo spazio: ciò che è alla sinistra sarà il valore.
OPZIONI
Attributo di definizione delle descrizioni di tutti i valori indicati nel precedente parametro VALS[ ].
Nel caso in cui il precedente parametro VALS[] sia presente, il valore di ritorno sarà quello del parametro VALS corrispondente all'opzione selezionata. Nel caso, invece, in cui il parametro non sia presente, il valore si desume dall'opzione andando a ricercare il primo spazio: ciò che è alla sinistra sarà il valore.
IDMENU
Permette di specificare se il campo dispone di un proprio menù di contesto definito in precedenza mediante una specifica @DEFCONTEXTMENU.
IDAUTORICDEC
Consente di associare al controllo le funzioni di ricerca e decodifica automatiche definite mediante la specifica @DEFAUTORICDEC.
CAMPOCALCOLATO
Consente l'attivazione del meccanismo di protezione da modifiche accidentali di campi calcolati che l'utente eccezionalmente può modificare (ovvero forzarne il valore).
BLOCCATO
Consente di definire una condizione per bloccare il campo calcolato da modifiche accidentali.
AZIONEBLOCCO
Consente di bloccare il campo calcolato da modifiche accidentali.
TABAUTOMATICO
Consente di effettuare il passaggio automatico di campo, quando l'utente completa il campo.
BOTTONE
Consente di associare ad un campo di edit un bottone finalizzato all'esecuzione di una o più funzioni organizzate su un menù di contesto.
HTML
Consente di trasformare il campo di edit in un editor HTML visuale e di formattare il testo con i tag HTML.
AZIONEINVIO
Consente di indicare il tasto da simulare alla pressione del tasto INVIO.
L'utilizzo del parametro implica l'utilizzo del parametro ID
CALCOLATRICE
Consente di richiamare una finestra di popup con al suo interno una calcolatrice standard.
Il risultato della calcolatrice (che si chiuderà alla pressione dell'invio o del tasto uguale) verrà riportato sul campo di edit. Le operazioni eseguite vengono mantenute in memoria per singolo edit fino alla chiusura della videata.
Parametro con valori ammessi, si possono utilizzare i seguenti valori:
| Valore | Descrizione |
|---|---|
0 | No |
1 | Si |
PASSWORD
Consente di impostare il campo di edit come tipo password.
In questo modo il testo viene automaticamente oscurato utilizzando un carattere costante.
L'utilizzo del parametro esclude l'utilizzo del parametro FMT
ETICHETTA
Consente di definire l'etichetta da visualizzare all'interno della videata di personalizzazione.
AUTOCOMPLETAMENTO
Consente di associare una query da utilizzare per gestire l'autocompletamento.
DROP
Consente di definire il comportamento da attenere nel caso in cui venga iniziata un'operazione di drag di Windows (esempio: trascinamento di una riga della griglia).
Consente di indicare:
- Il nome dell'oggetto (identificatore) da associare alle informazioni che vengono trasmesse, in modo che possano essere riconosciute dal controllo/programma di destinazione
- Una callback di programma che permette di specificare le informazioni in base allo stato corrente del controllo (valori della riga corrente della griglia ad esempio), mediante l'impiego della funzione @SETDRAGOBJECT
La funzione definisce la sorgente dati (le informazioni usate nel trascinamento come origine).
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 |
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
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
Consente di creare un legame tra due controlli esistenti all'interno della stessa videata.
RICORDA
Indica che il campo potrà prevedere il valore, memorizzando quelli precedentemente inseriti.
COMBOORA
Consente di personalizzare l'intervallo della combo su un campo con formato ora.
TOGGLE
Consente di visualizzare il campo di edit come un toggle.
SWITCH
Consente di visualizzare il campo di edit come uno switch.
DETTAGLIO
Consente di indicare il campo di edit come visualizzabile tramite 'Mostra di più'.
EVIDENZIATO
Evidenzia il controllo applicando uno sfondo.
ESTENDEINREPEATER
Consente di definire la larghezza di un edit, quando questo è contenuto in una @DEFSECTION con disposizione LINEARE, che a sua volta è contenuto in un @DEFTEMPLATE da ripetere tramite @DEFREPEATER.
Parametro enumerato, può assumere i seguenti valori:
| Valore | Descrizione |
|---|---|
PREDEFINITA | |
CRESCE | |
DIMEZZA |
Esempi
Edit con combo
DIM valore[INT] = 0
'@DEFVID DIM[20,70] TIT["Videata"] ID["IDVideata1"]
'@DEFGRIDPANEL NOME[GridPanel1] ID["IDGrid1"] _
RIGA[ALTEZZA[0.5] LAYOUT[#FISSO]] _
RIGA[ALTEZZA[1] LAYOUT[#FISSO]] _
RIGA[ALTEZZA[0.5] LAYOUT[#FISSO]] _
COLONNA[LUNGHEZZA[0.5] LAYOUT[#FISSO]] _
COLONNA[LUNGHEZZA[69] LAYOUT[#DINAMICO]] _
COLONNA[LUNGHEZZA[0.5] LAYOUT[#FISSO]] _
'@DEFEDIT VAR[valore] ID["IDEdit"] POS[1,1] DIM[1,1] RET[1,1] GRID[COL[2] RIGA[2] COLDIN[1]] FMT[NUMERICO[1]] _
COMBO ALTCOMBO[2] _
VAL[0] OPZIONE["Tutti"] _
VAL[1] OPZIONE["Nessuno"]
'@ENDGRIDPANEL NOME[GridPanel1]
'@RUNVID
Edit con autocompletamento
DIM varStringa[STRING]
DIM varAuto[STRING]
'@DEFVID DIM[20,70] TIT["Videata"] ID["IDVideata2"]
'@DEFGRIDPANEL NOME[GridPanel2] ID["IDGrid2"] _
RIGA[ALTEZZA[0.5] LAYOUT[#FISSO]] _
RIGA[ALTEZZA[1] LAYOUT[#FISSO]] _
RIGA[ALTEZZA[0.5] LAYOUT[#FISSO]] _
COLONNA[LUNGHEZZA[0.5] LAYOUT[#FISSO]] _
COLONNA[LUNGHEZZA[69] LAYOUT[#DINAMICO]] _
COLONNA[LUNGHEZZA[0.5] LAYOUT[#FISSO]] _
'@DEFEDIT VAR[varStringa] ID["IDEdit"] POS[1,1] DIM[1,1] RET[1,1] GRID[COL[2] RIGA[2] COLDIN[1]] FMT[TESTO] _
AUTOCOMPLETAMENTO[IDQUERY[IdQuery]] _
DECODVIDEO[VARVIDEO[varAuto] FMTVIDEO[TESTO]]
'@ENDGRIDPANEL NOME[GridPanel2]
'@RUNVID
Edit con bottone
DIM varStringa[STRING]
'@DEFVID DIM[20,70] TIT["Videata"] ID["IDVideata3"]
'@DEFGRIDPANEL NOME[GridPanel3] ID["IDGrid3"] _
RIGA[ALTEZZA[0.5] LAYOUT[#FISSO]] _
RIGA[ALTEZZA[1] LAYOUT[#FISSO]] _
RIGA[ALTEZZA[0.5] LAYOUT[#FISSO]] _
COLONNA[LUNGHEZZA[0.5] LAYOUT[#FISSO]] _
COLONNA[LUNGHEZZA[69] LAYOUT[#DINAMICO]] _
COLONNA[LUNGHEZZA[0.5] LAYOUT[#FISSO]] _
'@DEFEDIT VAR[varStringa] ID["IDEdit"] POS[1,1] DIM[1,1] RET[1,1] GRID[COL[2] RIGA[2] COLDIN[1]] FMT[TESTO] _
BOTTONE[AZIONE[AzioneBottone()]]
'@ENDGRIDPANEL NOME[GridPanel3]
'@RUNVID
Edit con bottone con esegui menù
DIM varStringa[STRING]
'@DEFVID DIM[20,70] TIT["Videata"] ID["IDVideata4"]
'@DEFGRIDPANEL NOME[GridPanel4] ID["IDGrid4"] _
RIGA[ALTEZZA[0.5] LAYOUT[#FISSO]] _
RIGA[ALTEZZA[1] LAYOUT[#FISSO]] _
RIGA[ALTEZZA[0.5] LAYOUT[#FISSO]] _
COLONNA[LUNGHEZZA[0.5] LAYOUT[#FISSO]] _
COLONNA[LUNGHEZZA[69] LAYOUT[#DINAMICO]] _
COLONNA[LUNGHEZZA[0.5] LAYOUT[#FISSO]] _
'@DEFEDIT VAR[varStringa] ID["IDEdit"] POS[1,1] DIM[1,1] RET[1,1] GRID[COL[2] RIGA[2] COLDIN[1]] FMT[TESTO] _
BOTTONE[AZIONE[ESEGUIMENU[Menu()]]]
'@ENDGRIDPANEL NOME[GridPanel4]
'@RUNVID
...
'@SRP Menu()
'Definizione menù
'@DEFCONTEXTMENU IDMENU["IDMenu"] _
TITOLO["Dettaglio"] _
AZIONE[AzioneBottone() ] _
TITOLO["Situazione contabile"] _
AZIONE[AzioneBottone2()] DISABILITATA[1]
'Esecuzione menù
'@EXECMENU IDMENU["IDMenu"] SELEZIONEAUTOMATICA[0]
Return