Pannello

Il pannello è un oggetto di interfaccia utente in grado di mostrare e modificare un record o una lista di record. Puo essere rappresentato dalle seguenti icone:

Pannello normale

Pannello collegato (DO)

Per creare nuovi pannelli puoi usare il menù contestuale del form editor, ma normalmente è più semplice tirare la tabella o il documento di cui si vogliono vedere i dati sulla videata o nel form editor.

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

Nome: rappresenta il nome 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 anche nell’interfaccia utente.

Descrizione: contiene una descrizione dello scopo del pannello. Il testo inserito verrà utilizzato per comporre il manuale utente.

Titolo: è il valore predefinito della proprietà Caption, usata come titolo del pannello. Normalmente viene lasciato vuoto ed, in questo caso, verrà usata la proprietà Nome.

Stile Visuale: è lo stile visuale che verrà applicato al pannello nel suo insieme. Se non specificato verrà usato lo stile Default Panel Style. In particolare i parametri applicati sono: il colore di sfondo del pannello, lo stile dei bordi del riquadro della lista e la distanza fra le righe.

Layout dettaglio: se impostato, indica che il pannello potrà mostrare un record o un documento in formato dettaglio.

Layout Lista: se impostato, indica che il pannello potrà mostrare una lista di record o documenti.

Abilitato: attualmente questo flag non viene utilizzato perché le funzionalità di modifica del pannello sono gestite da altri flag elencati nel seguito. Si consiglia di mantenere questo flag impostato in quanto potrebbe assumere significato in una prossima versione di In.de.

Visibile: se impostato il pannello risulterà visibile nell’interfaccia web.

Apri in dettaglio: indica che il pannello verrà aperto nel layout dettaglio.

Gestione layout automatica: se il pannello ha entrambi i layout, questo flag ne permette una gestione automatica. In particolare:

• Se il pannello entra nello stato QBE, esso viene portato in dettaglio, in modo che l’utente possa impostare criteri di ricerca su tutti i campi.
• Quando l’utente esegue la ricerca, se si trova più di un record il pannello viene portato in lista, altrimenti rimane in dettaglio.
• Premendo il tasto Insert per inserire un nuovo record il pannello viene portato in dettaglio.

Attiva scrollbar: impostando questo flag il pannello mostrerà la scrollbar nella lista dei record. Anche se la scrollbar non è visibile, sarà comunque possibile spostarsi nella lista sia con la tastiera che con i pulsanti di navigazione nella toolbar del pannello.

Salva automaticamente: se impostato, il pannello salverà immediatamente le modifiche fatte dall’utente. Le conseguenze del salvataggio sono diverse in base al tipo di pannello:

• Master query su tabella di database: dopo la fase di validazione, se non ci sono errori, il pannello salva i dati direttamente nel database.
• Master query su tabella in memoria: dopo la fase di validazione, se non ci sono errori, il pannello salva i dati nella tabella in memoria. In questo caso è sempre opportuno lasciare attivo questo flag.
• Master query su documento: il pannello salva subito i dati nel documento che esegue la fase di validazione. In questo caso è necessario lasciare attivo questo flag perché è il documento che deve rispondere alle modifiche effettuate nel pannello e quindi le deve conoscere prima possibile.

Ridimensionamento orizzontale: imposta la regola di ridimensionamento orizzontale della lista del pannello nel suo complesso:

• Nessuna azione: la lista del pannello non cambia la sua larghezza.
• Muovi: se il pannello si allarga, la lista viene spostata verso destra, se il pannello si stringe, la lista viene spostata verso sinistra.
• Adatta: la lista cambia larghezza in base al cambiamento di dimensione del pannello. I campi in essa contenuti cambieranno dimensione in funzione dei parametri di ridimensionamento dei campi stessi.

Ridimensionamento verticale: imposta la regola di ridimensionamento verticale della lista del pannello nel suo complesso:

• Nessuna azione: la lista del pannello non cambia la sua altezza.
• Muovi: se il pannello si alza, la lista viene spostata verso il basso, se il pannello si stringe, la lista viene spostata verso l’alto.
• Adatta: la lista cambia altezza in base al cambiamento di dimensione del pannello. Il numero di righe della lista cambierà in funzione della variazione di altezza.

Può aggiornare: se impostato, questo flag indica che sarà possibile modificare dati già esistenti nel pannello.

Può cancellare: se impostato, questo flag indica che sarà possibile cancellare le righe del pannello.

Può inserire: se impostato, questo flag indica che sarà possibile aggiungere nuove righe al pannello.

Può ricercare: se impostato, questo flag indica che sarà possibile effettuare ricerche query by example nel pannello.

Stato iniziale: indica in quale stato si deve trovare il pannello quando la videata viene aperta:

• Ricerca (QBE): il pannello si predispone per l’inserimento dei criteri di ricerca query by example.
• Trova Dati: in pannello esegue già la master query e visualizza i dati trovati. La query verrà eseguita solo con i filtri impostati a desgn time sulla master query.
• Nuova riga (pronto per l’inserimento): in pannello si predispone per l’inserimento di una nuova riga, eseguendo una query vuota fittizia. Il pannello non entra però in stato modificato.
• Nuova riga (in stato modificato): in pannello si predispone per l’inserimento di una nuova riga, eseguendo una query vuota fittizia. Il pannello entra in stato modificato, inserendo così i valori di default a video, mostrando i campi obbligatori ed eseguendo le procedure di validazione della nuova riga che si sta inserendo.

• Imposta valori lookup e trova: il pannello riceve alcuni parametri QBE dalla form chiamante e li usa per eseguire la query. E’ utile per videate di lookup in cui si vuole mostrare il dettaglio del documento collegato. Se non c’è un documento collegato, il pannello rimane in stato QBE.
• Imposta valori lookup, trova comunque: il pannello riceve alcuni parametri QBE dalla form chiamante e li usa per eseguire la query. E’ utile per videate di lookup in cui si vuole mostrare il dettaglio del documento collegato, oppure la lista dei possibili documenti da selezionare. Se non c’è un documento collegato, il pannello esegue comunque la master query.

• Usa icone piccole: se impostato, nella toolbar del pannello verranno mostrate icone più piccole del normale. Utile per sotto-pannelli.

• Selettore di riga: se impostato il pannello mostrerà una freccina sulla sinistra di ogni riga, utile per attivare la riga, o per effettuare una selezione multipla.

• Mostra status bar: se impostato il pannello visualizzerà nella barra del titolo lo stato attuale.

• Mostra toolbar: se impostato il pannello mostrerà i pulsanti della toolbar nella barra del titolo.

• Riordina colonne: se impostato permette all’utente di trascinare la caption delle colonne nella lista per riordinarle.

• Ridimensiona colonne: se impostato permette all’utente di trascinare il bordo della caption delle colonne nella lista per ridimensionarle. E’ anche possibile fare doppio click sul bordo della colonne per ottenere il ridimensionamento automatico in base alla larghezza dei dati.

• Attiva drag: se impostato permette all’utente di trascinare le celle ed i campi del pannello in altre parti dell’interfaccia utente.

• Attiva drop: se impostato permette al pannello di accettare il trascinamento di altri oggetti dell’interfaccia. Al momento del drop verranno notificati gli eventi OnGenericDrag e OnGenericDrop per consentire la gestione dell’operazione di trascinamento.

• Può raggruppare: se impostato attiva la funzione di raggruppamento righe al posto di quella di ordinamento.

• Mostra gruppi: se il raggruppamento è attivato, questo flag permette di ottenere subito la visualizzazione dei gruppi invece che l'elenco delle righe. Per ottenere i gruppi è necessario impostare almeno un criterio di ordinamento nella master query del pannello.
• Ridim.Campi Visibili: Indica se lo spazio riservato ai campi invisibili in lista deve rimanere bianco oppure essere recuperato e utilizzato dagli altri campi.

Dimensione Minima L: è la larghezza minima a cui verrà ridimensionato il pannello quando la videata riduce la sua larghezza.

Dimensione Minima A: è l’altezza minima a cui verrà ridimensionato il pannello quando la videata riduce la sua altezza.

Dimensione Massima L: è la larghezza massima a cui verrà ridimensionato il pannello quando la videata aumenta la sua larghezza.

Dimensione Massima A: è l’altezza massima a cui verrà ridimensionato il pannello quando la videata aumenta la sua altezza.

Icona: è l’icona del pannello, mostrata nel lato sinistro della barra del titolo. Se l’icona non viene impostata nel pannello In.de comunque cerca di reperire l’icona dal documento o dalla tabella di cui il pannello mostra i dati.

Larghezza fissa: impostando questo flag la larghezza del pannello non varierà quando la videata viene ridimensionata la larghezza.

Altezza fissa: impostando questo flag l’altezza del pannello non varierà quando la videata viene ridimensionata in altezza.

Nascondi riquadro: impostando questo flag verrà visualizzato solo il contenuto del pannello e non la barra del titolo.

Mostra bordo: se attivo indica che il sistema inserirà un bordino di separazione tra riquadri contigui. Per esempio se una videata contiene due riquadri, uno a sinistra ed uno a destra, e si attiva il flag verrà mostrata una riga verticale di separazione tra i due riquadri.

Codice: è il nome della variabile che rappresenta il 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 pannello. Si consiglia di non modificare questa opzione.

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