Scopo
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.
E' consigliato utilizzare questa funzione per salvare il layout visuale del pannello solo negli eventi che vengono scatenati da una azione esplicita dell'utente, cioè
OnReorderColumn e
OnResizeColumn.