L'aggiornamento di record |
  
|
L'aggiornamento di record |
|
In caso l'Edit Mode della sottostante tabella del Model si Full o Simple, è possibile abilitare la modifica a video del contenuto dei record di una Band.
Per abilitare l'aggiornamento a video di uno o più record è necessario agire sui valori assunti dalle seguenti Band Property di tipo Edit nella classe Override:
✓ AllowUpdate consente di abilitare/disabilitare la modifica a video dei record della Band corrente;
✓ CellClickAction specifica il comportamento delle celle quando sono selezionate con il tasto sinistro del mouse.
Il valore Default della proprietà AllowUpdate coincide con False, anche in caso la sottostante tabella del Model sia in Full o Simple Edit Mode. |
La proprietà CellClickAction può assumere i valori:
✓ Edit rende modificabile il contenuto della cella corrente;
✓ RowSelect seleziona tutta la riga corrispondente alla cella corrente, senza abilitarne la modifica;
✓ CellSelect seleziona la cella corrente senza abilitarne la modifica;
✓ EditAndSelectText seleziona e rende modificabile il contenuto della cella corrente;
✓ Default coincide con RowSelect.
Per abilitare l'aggiornamento a video dei record di una Band è necessario impostare: ✓ la proprietà AllowUpdate a True; ✓ la proprietà CellClickAction a Edit o EditAndSelectText. |
È possibile specializzare, colonna per colonna, il comportamento impostato dalla proprietà CellClickAction mediante la Column Property di tipo Edit CellActivation. Essa può assumere i valori:
✓ AllowEdit rende modificabile il contenuto delle celle della colonna corrente;
✓ ActivateOnly rende selezionabile ma non modificabile il contenuto delle celle della colonna corrente;
✓ Disabled disabilita il contenuto delle celle della colonna corrente;
✓ NoEdit impedisce la modifica del contenuto delle celle della colonna corrente.
In caso la proprietà CellClickAction sia Edit o EditAndSelectText, essa può essere sovrascritta da eventuali valori assunti dalla proprietà CellActivation.
Viceversa in caso la proprietà CellClickAction assuma un valore che inibisce la modifica a video dei dati, essa può sovrascrive gli eventuali valori assunti dalla proprietà CellActivation. In particolare, in caso il suo valore sia RowSelect, essa inibisce la selezione delle singole celle componenti un record, impedendo la selezione delle colonne e la modifica delle corrispondenti Column Property.
Mediante le seguenti Column Property è invece possibile definire specifiche maschere di input, mediante le quali guidare l'immissione dei dati nelle celle di una data colonna:
✓ MaskInput definisce, in un apposito linguaggio proprietario, una stringa che definisce in modo formale il formato della maschera di input;
✓ MaskDisplayMode specifica il formato con cui visualizzare il contenuto di una cella quando essa non risulta in modifica;
✓ MaskClipMode imposta il formato con cui il contenuto di una cella può essere copiato;
✓ MaskDataMode specifica il formato con cui il contenuto di una cella sarà inviato al DB di destinazione;
✓ MaskLiteralAppearance definisce uno stile grafico per le parti non modificabili della maschera di input (e.g. spazi o caratteri separatori come trattini e virgole).
Si dicono Literal character i caratteri non modificabili di una maschera di input. |
La stringa di definizione di un MaskInput si può comporre dei caratteri riportati nella seguente tabella.
Carattere |
Descrizione |
|---|---|
# |
Una qualsiasi cifra da 0 a 9, che deve essere sempre valorizzato. |
9 |
Una qualsiasi cifra da 0 a 9, che può non essere valorizzata. |
n |
Una qualsiasi cifra da 0 a 9, che può non essere valorizzata. Utilizzato per definire numeri da valorizzare da destra verso sinistra |
- |
Segno meno per numeri negativi in caso sia seguito da una sequenza di cifre numeriche. Esso è visualizzato solo se il numero seguente è effettivamente negativo. |
& |
Un qualsiasi carattere della tastiera o uno spazio, che può non essere valorizzato. |
C |
Coincide con &, garantendo compatibilità con Microsoft Access®. |
A |
Un qualsiasi carattere alfanumerico, che deve essere sempre valorizzato. |
a |
Un qualsiasi carattere alfanumerico, che può non essere valorizzato. |
? |
Una qualsiasi lettera minuscola o maiuscola, che può non essere valorizzato. |
dd |
Giorno in una data del tipo dd/mm/yy o mm/dd/yy. |
mm |
Mese in una data del tipo dd/mm/yy o mm/dd/yy. |
yy |
Anno a due cifre in una data del tipo dd/mm/yy o mm/dd/yy. |
yyyy |
Anno a quattro cifre in una data del tipo dd/mm/yyyy o mm/dd/yyyy. |
hh |
Ora in un formato ora del tipo hh:mm:ss. |
mm |
Minuti in un formato ora del tipo hh:mm:ss. |
ss |
Secondi in un formato ora del tipo hh:mm:ss. |
tt |
Scritta AM o PM che segue un'ora nel formato hh:mm:ss. |
. |
Separatore decimale, considerato come Literal character. |
, |
Separatore delle migliaia, considerato come Literal character. |
: |
Separatore nelle ore, considerato come Literal character. |
/ |
Separatore nelle date, considerato come Literal character. |
- |
Trattino separatore in caso non sia seguito da una sequenza di cifre numeriche. Esso è considerato come Literal character. |
+ |
Segno meno per numeri positivi e negativi in caso sia seguito da una sequenza di cifre numeriche. Esso visualizza un '+' se il numero seguente è positivo, mentre visualizza un '-' se il numero seguente è negativo. |
$ |
Simbolo di valuta, considerato come Literal character. |
Sono inoltre disponibile caratteri speciali, descritti nella seguente tabella, per la personalizzazione del MaskInput.
Carattere |
Descrizione |
|---|---|
\ |
Rende il carattere che lo segue un Literal character. Permette di utilizzare nelle maschere di input anche caratteri speciali come #, : e &. |
> |
Rende maiuscoli tutti i caratteri che lo seguono. |
< |
Rende minuscoli tutti i caratteri che lo seguono. |
Per date e ore esistono anche MaskInput predefiniti dal sistema, che ereditano i regional settings della macchina corrente. Essi sono richiamabili, rispettivamente, con le stringhe {date} e {time}.
La prorietà MaskInput è efficace solo se la proprietà di colonna CellMultiLine è impostata a False. |
Le proprietà MaskDisplayMode può assumere i valori:
✓ Raw visualizza le sole parti compilate del contenuto di una cella;
✓ IncludeLiterals visualizza le sole parti compilate e i Literal character;
✓ IncludePromptChars visualizza le parti compilate, quelle eventualmente non compilate sostituite da caratteri undrerscore, ma non i Literal character.
✓ IncludeBoth combina il comportamento di IncludeLiterals e IncludePromptChars.
✓ IncludeLiteralsWithPadding coincide con IncludeBoth, ma le parti eventualmente non compilate sono sostituite da spazi.
Si dicono: ✓ Prompt character gli elementi non compilati di una maschera di input; ✓ Pad character gli spazi vuoti che sostituiscono elementi non compilati di una maschera di input. |
Le proprietà MaskDisplayMode può assumere i valori:
✓ Raw copia le sole parti compilate della cella;
✓ IncludeLiterals copia le sole parti compilate e i Literal character;
✓ IncludePromptChars copia le parti compilate, quelle eventualmente non compilate sostituite da caratteri undrerscore, ma non i Literal character.
✓ IncludeBoth combina il comportamento di IncludeLiterals e IncludePromptChars.
✓ IncludeLiteralsWithPadding coincide con IncludeBoth, ma le parti eventualmente non compilate sono sostituite da spazi.
Le proprietà MaskDataMode può assumere i valori:
✓ Raw invia al DB le sole parti compilate della cella;
✓ IncludeLiterals invia al DB le sole parti compilate e i Literal character;
✓ IncludePromptChars invia al DB le parti compilate, quelle eventualmente non compilate sostituite da caratteri undrerscore, ma non i Literal character.
✓ IncludeBoth combina il comportamento di IncludeLiterals e IncludePromptChars.
✓ IncludeLiteralsWithPadding coincide con IncludeBoth, ma le parti eventualmente non compilate sono sostituite da spazi.