funzioneScopo
Questa funzione restituisce una stringa contenente una descrizione XML dello stato a run time del pannello, stato costituito dalla disposizione e alla larghezza dei campi a run time e al 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 di questa funzione è di restituire una descrizione del layout del pannello visto dall'utente; questo layout può venire salvato e ripristinato utilizzando la procedura SetPanelConfiguration.
Il layout del pannello a run time può essere differente da quello a design time per due motivi:
- Se il pannello ha la proprietà CanReorderColumn abilitata l'utente può aver cambiato l'ordine delle colonne nella lista.
- La dimensione delle colonne può dipendere da un eventuale resize del pannello oppure da un ridimensionamento effettuato dall'utente, se il pannello ha la proprietà CanResizeColumn abilitata.
Sintassi
//
// Salvo la configurazione del pannello in una stringa
configurazione := Fornitori.GetPanelConfiguration()
Valore di ritorno
Viene ritornata una stringa che contiene in formato XML la descrizione del layout del pannello visto dall'utente. Il layout consiste nell'ordine dei campi in lista ed in dettaglio e nella larghezza dei campi in lista. Viene salvato anche il valore della proprietà FixedColumns.
Note
- E' consigliato utilizzare questa funzione negli eventi che vengono scatenati da una azione di cambiamento della visualizzazione del pannello effettuata esplicitamente dall'utente, cioè OnReorderColumn e OnResizeColumn.
- Tra le informazioni salvate si trova anche il valore della proprietà FixedColumns del pannello perchè l'utente può riordinare le colonne trascinandole dentro o fuori l'area fissa, variando quindi il valore di questa proprietà.
Esempio di codice
// Evento notificato quando l'utente riordina le colonne della lista
// *****************************************************************
event Fornitori1.Fornitori.OnReorderColumn(
int SourceField // E' un numero intero che rappresenta Field tirato
int TargetField // E' il numero che rappreseta il field su cui è stato t...
)
{
// Salvo la configurazione impostata dall'utente su una stringa
Test.Panelconfig.Configurazione := Fornitori.GetPanelConfiguration()
}
Ultima modifica: 20/11/2020 / Validità: da 8.5.3800