Navigation:  I Viewer: esposizione dei dati > Il Viewer Grid > Le Property di una Grid > Esempi di Edit Property > L'inserimento di nuovi record

In caso l'Edit Mode della sottostante tabella del Model si Full o Simple, è possibile abilitare l'inserimento a video di uno o più nuovi record in una Band.

Per abilitare l'inserimento a video di nuovi record è necessario agire sui valori assunti dalle seguenti Edit Property:

✓ AddNewBox, classe di Grid Property che consente di definire un apposito riquadro al di sotto della Grid, contenente un pulsante per l’accodamento di nuove righe;

✓ AllowAddNew, Band Property che consente di abilitare/disabilitare la possibilità di accodare nuove righe, specificandone la modalità di visualizzazione.

 

La classe AddNewBox si compone delle proprietà:

✓ Hidden visualizza/nasconde l'apposito riquadro per l'accodamento di nuovi record alla Grid corrente;

✓ Appearance consente di personalizzare l’aspetto grafico del riquadro dedicato all'accodamento di nuovi record.

Inoltre, è anche possibile personalizzare l'aspetto del pulsante per l'accodamento di nuovi record mediante le seguenti proprietà:

✓ ButtonAppearance, Grid Property che consente di personalizzare l’aspetto grafico del pulsante;

✓ AddButtonCaption, Band Property che consente di modificare il testo visualizzato all'interno del pulsante.

 

La proprietà AllowAddNew può assumere i valori:

✓ Yes abilita la possibilità di accodare nuove righe mediante l'apposito riquadro AddNewBox;

✓ No disabilita ogni possibilità di accodare nuove righe alla Band corrente;

✓ TabRepeat consente di aggiungere nuovi record premendo il tasto TAB nell’ultima cella in basso a destra della Band corrente;

✓ TemplateOnTop accoda automaticamente nuove righe in cima alla Band corrente;

✓ TemplateOnTopWithTabRepeat combina i comportamenti di TemplateOnTop e TabRepeat;

✓ TemplateOnBottom accoda automaticamente nuove righe in fondo alla Band corrente;

✓ FixedAddRowOnTop crea un’area fissa in cima alla Band corrente dove compilare le righe da accodare;

✓ FixedAddRowOnBottom crea un’area fissa sotto la Band corrente dove compilare le righe da accodare;

✓ Default coincide con Yes.

 

In caso di AllowAddNew pari a FixedAddRowOnTop e FixedAddRowOnBottom, l'inserimento del nuovo record, compilato nell'area dedicata, può essere accodato alla Band corrente in uno dei seguenti modi:

✓ premendo il tasto Enter da tastiera;

✓ premendo l'apposito pulsante nel riquadro AddNewBox dedicato.

 

Per ogni valore della proprietà AllowAddNew di tipo OnTop/OnBottom è possibile personalizzare la riga dedicata all’inserimento di nuovi record, mediante le seguenti Band Property della classe Override:

✓ TemplateAddRowAppearance personalizza l’aspetto grafico della riga dedicata all’inserimento di nuovi record;

✓ TemplateAddRowCellAppearance personalizza l’aspetto grafico delle celle della riga dedicata all’inserimento di nuovi record;

✓ TemplateAddRowPrompt specifica il contenuto del prompt associato alla riga dedicata all’inserimento di nuovi record;

✓ TemplateAddRowPromptAppearance personalizza l’aspetto grafico del prompt associato alla riga dedicata all’inserimento di nuovi record

 

Per poter apprezzare le differenze tra le proprietà TemplateAddRowAppearance e TemplateAddRowCellAppearance è necessario attribuire alla Band Property CellSpacing, nella classe Override, un valore positivo e non nullo. Questa proprietà infatti permette di creare uno spazio in pixel intorno alle celle di una riga.

 

L'accodamento di nuovi record può avvenire anche in modo automatizzato mediante opportuni Command di tipo Run SQL. In questi casi è possibile definire il comportamento della griglia in fase di inserimento, mediante la Band Property RowAddedBehaviour. Essa può assumere i valori:

✓ None, il sistema non apporta modifiche alla visualizzazione;

✓ Activate, la riga inserita coincide con quella attiva;

✓ Select, la riga inserita coincide con quella selezionata;

✓ Edit, il contenuto del primo campo modificabile della nuova riga risulta selezionato;

✓ Scroll, il sistema scorre la griglia fino al nuovo record inserito;

✓ Default coincide con None.