funzioneScopo
Questa procedura prende in ingresso una stringa XML che contiene la descrizione del layout del pannello, solitamente ottenuta attraverso la funzione GetPanelConfiguration, e la ripristina.
In particolare vengono ripristinate le posizioni dei campi in lista e le loro dimensioni, inoltre viene ripristinato il valore della proprietà FixedColumns del pannello.
Dalla versione 16.5 viene considerata anche la visibilità dei campi e i criteri di ordinamento.
Dalla versione 18.0 viene considerato anche lo stato di collassamento dei gruppi di campi.
Lo scopo delle due funzioni GetPanelConfiguration e SetPanelConfiguration è di rendere possibile il salvataggio sul database del layout scelto dall'utente e il successivo ricaricamento e applicazione del layout.
Sintassi
Pannello.SetPanelConfiguration(configurazione)
Argomenti
| Configurazione | Stringa contenente la descrizione XML del layout del pannello. Solitamente ottenuta attraverso la funzione GetPanelConfiguration. |
Valore di ritorno
Nel caso l'XML contenga campi cancellati o il pannello contenga campi non presenti nell'XML il framework cerca di operare al meglio, ignorando i campi non presenti ed inserendo i nuovi campi all'inizio o alla fine della lista. In questo caso viene ritornato False, per indicare che il layout contenuto nell'XML è differente da quello del pannello, altrimenti viene ritornato True.
Esempio di codice
// Evento notificato alla videata al momento del caricamento in memoria.
// *********************************************************************
event Fornitori1.Load()
{
// Attivo il riordinamento delle colonne della lista
Fornitori.CanReorderColumn := True
//
// Attivo il resize delle colonne della lista
Fornitori.CanResizeColumn := True
//
// Se ho salvato una configurazione all'apertura della videata la riapplico
if NOT(IsNull(Test.Panelconfig.Configurazione))
{
// Riapplico la configurazione salvata
Fornitori.SetPanelConfiguration(Test.Panelconfig.Configurazione)
}
}
- E' consigliato utilizzare questa funzione nell'evento di Load della videata, per ripristinare il layout scelto dall'utente.
- Se usata in un evento diverso dal Load non è garantito che la funzione riesca a ripristinare l'intera configurazione, ad esempio potrebbe riuscire a ridimensionare i campi in lista ma non a cambiarne l'ordine.
- La stringa XML di descrizione deve essere relativa allo stesso pannello, altrimenti non verrà applicata e verrà restituito False.
- Il framework cerca di applicare l'ordinamento passato, ignorando eventuali campi cancellati ed inserendo nei punti corretti eventuali campi non presenti nell'XML.
Ultima modifica: 27/10/2023 / Validità: da 8.5.3800