Campo di pannello

Un campo di pannello rappresenta l’oggetto grafico usato per presentare le informazioni nel pannello. Può essere identificato da una delle seguenti icone:

Campo pannello master

Campo pannello lookup

Campo pannello statico o nascosto

Campo con oggetto di attivazione

I campi master e lookup vengono creati dal menù contestuale delle colonne delle rispettive query, i campi statici vengono creati nel form editor. E' anche possibile tirare i campi delle tabelle o le proprietà degli oggetti direttamente nel pannello visualizzato nel form editor.

Video corso: Videata con pannelli in master detail
Video corso: Concetto di pannello

Nome: rappresenta il nome del campo del pannello, così come sarà riconosciuto all'interno del progetto Instant Developer. Se non si modifica la proprietà Titolo, il nome del pannello verrà mostrato come titolo delle colonne e dei campi all’interno dell’interfaccia e nel manuale utente.

Descrizione: contiene una descrizione dell’utilizzo del campo. Il testo inserito verrà mostrato come tooltip e utilizzato per comporre il manuale utente. In caso di campo statico, il testo della descrizione viene mostrato all’interno del campo stesso, a meno che non sia stata impostata anche la proprietà Titolo.

Titolo: è il valore predefinito della proprietà Caption del campo, utilizzata come titolo delle colonne e dei campi all’interno dell’interfaccia e nel manuale utente. Normalmente viene lasciato vuoto ed, in questo caso, verrà usata la proprietà Nome. Impostando il Titolo di un campo statico, il valore della proprietà sarà utilizzato per definirne il contenuto.

Watermark: Permette di definire una stringa che verrà mostrata se il campo è vuoto, come aiuto per l'utente.

Stile visuale: è lo stile visuale che verrà applicato al campo. Se non specificato, In.de cercherà se è stato specificato uno stile visuale nella proprietà o nel campo della tabella da cui il campo di pannello deriva. Se non viene trovato, allora verranno applicati i seguenti stili predefiniti, in base al tipo di campo:

• Primary Key Fields: se il campo master deriva da una proprietà o campo di tabella di tipo chiave primaria.
• Foreign Key Fields: se il campo master deriva da una proprietà o campo di tabella appartenente ad una relazione.
• Normal Fields: altri tipi di campi master.
• Lookup Fields: se il campo è di lookup.
• Static Fields: se il campo è statico.

Visibile: indica che il campo di pannello sarà inizialmente visibile quando la videata che contiene il pannello viene aperta. Tramite il metodo SetVisible sarà possibile modificare a runtime questa proprietà.

Abilitato: indica che il campo di pannello sarà inizialmente editabile quando la videata che contiene il pannello viene aperta. Tramite il metodo SetEnabled sarà possibile modificare a runtime questa proprietà.

Attivo: impostando questo flag, quando l’utente modifica il campo e sposta il fuoco in un altro posto, il server web viene immediatamente avvertito della notifica. In caso contrario la notifica avverrà in modo ritardato insieme con altri eventi, per non sovraccaricare di richieste il server. In caso di campi smart lookup la notifica avviene anche prima che l’utente abbia spostato il fuoco in un altro campo per ottenere la funzionalità di autocompletamento. E’ conveniente impostare questo flag quando:

• le modifiche al campo causano modifiche al layout dell’interfaccia utente (es: attivando un checkbox devono essere nascosti altri campi);
• le modifiche al campo causano modifiche al funzionamento di altri elementi dell’interfaccia utente, come nel caso di combo-box collegate fra loro;
• le modifiche al campo devono essere immediatamente validate in quanto l’utente deve essere subito informato dell’esito della validazione;
• in caso di campo di smart lookup per ottenere l’effetto di autocompletamento.

Testo verticale: attualmente questo flag non viene utilizzato, in una futura versione di In.de potrà servire per ruotare di 90° il testo contenuto nel campo. L’implementazione di questa funzione dipenderà dalla disponibilità della stessa all’interno dei browser supportati.

Lookup automatico: in caso di campo di pannello master che contiene una query lista valori, l’impostazione di questo flag causa l’attivazione del meccanismo di auto-lookup. In questa modalità l’utente vede solo la descrizione del valore estratta dalla query e non il codice sotteso. Si consiglia di utilizzare il lookup automatico solo quando il numero di righe ritornate dalla query lista valori è basso (circa 30).

Non cliccabile se disabilitato: se impostato indica che è possibile attivare l’oggetto collegato al campo anche se quest'ultimo è disabilitato. I campi possono essere attivati con il doppio click o con il click sul pulsante di attivazione; gli oggetti che possono essere collegati al campo sono procedure (lanciate all’attivazione), videate (aperte all’attivazione), e command set (aperti in popup all’attivazione).

Sfondo: è l’immagine che verrà mostrata come sfondo del campo di pannello, può essere utile soprattutto per i campi statici, per creare bottoni cliccabili con immagine di sfondo.

Ridimensionamento immagine: permette di decidere se l'immagine di sfondo del campo deve essere ripetuta, centrata o adattata. Nel caso il campo sia di tipo BLOB e stia mostrando un'immagine in anteprima permette di decidere il ridimensionamento dell'immagine; in questo caso se il valore è Ripeti l'immagine non viene ridimensionata,se vale Centra l'immagine viene ridimensionata mantenendone le proporzioni e se vale Riempi viene ridimensionata senza mantenerne le proporzioni; questa funzionalità è stata introdotta nella versione 10.1 e solo in RD3.

Mostra in dettaglio: indica se il campo deve essere mostrato all'utente quando il pannello è in layout dettaglio.

Mostra in lista: indica se il campo deve essere mostrato all'utente quando il pannello è in layout lista.

Intestazione in alto in dettaglio: indica se l'intestazione del campo deve essere mostrata in alto anziché a sinistra quando il pannello è in layout dettaglio.

Intestazione in alto in lista: se il campo non è parte della lista, indica se l'intestazione deve essere mostrata in alto anziché a sinistra quando il pannello è in layout lista.

Nascondi intestazione in dettaglio: indica se l'intestazione del campo deve essere nascosta quando il pannello è in layout dettaglio.

Nascondi intestazione in lista: indica se l'intestazione del campo deve essere nascosta quando il pannello è in layout lista.

Proprietà visuali: questi flag attivano o disattivano alcune funzioni del campo di pannello.

• Può ordinare: se impostato permette di cliccare sulla caption del campo in lista per ottenere l’ordinamento dei dati secondo questo campo. E’ valido per campi master, oppure anche per campi di lookup nel caso in cui sia stato usato il comando Rendi Ordinabile.
• Gruppi automatici: in caso di pannelli con dati raggruppati, In.de decide automaticamente l'ampiezza dei gruppi. Se, ad esempio, il campo contiene una descrizione, tutti i valori che iniziano per la stessa lettera verranno a far parte dello stesso gruppo. E' possibile decidere manualmente l'ampiezza dei gruppi tramite il metodo AddGroupInterval.

• Per ogni tasto: attivando questo flag il campo di pannello comunicherà al server le modifiche prima ancora che l'utente sia uscito dal campo stesso. Conviene attivarlo solo se è importante che l'applicazione risponda immediatamente alle modifiche apportate al testo del campo.
• Solo icona: attivando questo flag il campo di pannello mostrerà solo l'icona e non il valore. Utile per campi associati ad una lista valori con immagine, se deve essere mostrata solo l'icona.

• Mostra attivatore: disattivando questo flag il campo di pannello non mostrerà il pulsante di attivazione anche se il campo ha un oggetto di attivazione collegato. Il campo sarà comunque attivabile con il doppio click o con il tasto F2.
• Obbligatorio: attivando questo flag viene forzato il controllo relativo alla presenza di dati nel campo. Anche se questo flag non è attivo, il campo può comuqnue risultare obbligatorio in funzione degli altri vincoli presenti nel progetto.
• Cliccabile: rende il campo cliccabile anche senza utilizzare uno stile visuale che specifica il flag corrispondente.
• Esporta nomi: se il campo è collegato ad una lista valori ed il contenuto del pannello viene esportato il sistema utilizza il nome delle costanti invece del loro valore.

• Tab automatico: se il campo prevede una lunghezza massima (o ha una maschera collegata che ha una lunghezza massima) e viene attivato il flag visuale, il fuoco viene automaticamente dato al campo successivo nell'ordine di tabulazione non appena il campo attuale raggiunge la lunghezza massima.
• Usa wmk come valore nullo: se il flag è abilitato ed il campo è di tipo Lista Valori, Value Source Query o Smartlookup il testo presente nel Watermark del campo viene applicato anche al valore opzionale presente nella lista della Combo, permettendo quindi di personalizzarlo (normalmente il testo mostrato come valore opzionale è stringa vuota o '-' nel caso di SmartLookup).

Colore di sfondo: permette di impostare il colore di sfondo del campo. In questo modo non è più necessario creare uno stile visuale apposito. E' possibile modificare questa impostazione a run-time tramite la proprietà dinamica BackgroundColor.

Colore del testo: permette di impostare il colore del testo del campo. In questo modo non è più necessario creare uno stile visuale apposito. E' possibile modificare questa impostazione a run-time tramite la proprietà dinamica TextColor.

Maschera di editing: permette di impostare la maschera di formattazione ed editing del campo. In questo modo non è più necessario creare uno stile visuale apposito. E' possibile modificare questa impostazione a run-time tramite la proprietà dinamica Mask.

Tipo di carattere: permette di impostare gli attributi grassetto, corsivo, sottolineato e barrato. In questo modo non è più necessario creare uno stile visuale apposito. E' possibile modificare questa impostazione a run-time tramite la proprietà dinamica FontModifiers.

Allineamento: permette di impostare l'allineamento del campo. In questo modo non è più necessario creare uno stile visuale apposito. E' possibile modificare questa impostazione a run-time tramite la proprietà dinamica Alignment.

Codice: è il nome della costante che identifica il campo di pannello all’interno del codice sorgente. Non è consigliabile modificare questa proprietà.

Automatico: se impostato indica che la proprietà Codice verrà automaticamente calcolata e disambiguata in base al nome del campo. Si consiglia di non modificare questa opzione.

Class name: permette di specificare una o più classi CSS aggiuntive da applicare all'header ed al valore del campo. Tali classi possono essere separate con il carattere ',' per identificare quelle da applicare all'header e quelle da applicare al valore.

Eventi: tramite questo sottomenù puoi aggiungere le procedure di gestione degli eventi notificati dal campo. Per maggiori informazioni sugli eventi disponibili vedi la libreria Campo di pannello.