proceduraScopo
Permette di mostrare a video un messaggio che verrà visualizzato nella barra dei messaggi, sopra la caption del form.
Sintassi
Form.ShowMessage(type, text, icon, code, permanent)
Argomenti
| Type | È un numero intero rappresentante il tipo di messaggio da mostrare, vedere la lista valori MessageTypes per ulteriori chiarimenti. |
| Text | È una stringa contenente il testo del messaggio da mostrare a video. |
| Icon | È parametro opzionale di tipo stringa che contiene il nome del file icona da associare al messaggio; se lasciato vuoto verrà visualizzata l'icona standard in base al tipo di messaggio. |
| Code | È un parametro opzionale di tipo stringa che consente di identificare il messaggio. Se si chiama più volte la ShowMessage con lo stesso codice messaggio, esso verrà sostituito. |
| Permanent | E' un parametro opzionale booleano che se impostato a True consente di rendere permanente il messaggio. Se lasciato vuoto (o False) il messaggio sarà temporaneo, quindi viene cancellato automaticamente dopo che l'utente lo ha visto. |
Esempio di codice
// **************************************************
// Fired after changes in panel are saved to database
// **************************************************
event Ordini.PanelSettings.AfterCommit(
int RowsUpdated // Number of rows inserted or updated
int RowsInErrors // Number of rows that cannot be updated due to databas...
)
{
// Modifico la modalità di autosave del form a seconda della scelta
// dell'utente. Nel campo AutoSaveTypesPanelSetting è contenuto un valore
// appartenente alla lista valori AutoSaveTypes.
this.AutoSaveType := PanelSettings.AutoSaveTypesPanelSetting
//
// Mostro a video un messaggio che avvisa l'utente della modifica del
// comportamento dell'interfaccia
this.ShowMessage(INFO, FormatMessage(MSG Valore Della, Decode(
PanelSettings.AutoSaveTypesPanelSetting, AutoSaveTypes), ??, ??, ??, ??),
Empty String, C001, False)
}
// Fired after changes in panel are saved to database
// **************************************************
event Ordini.PanelSettings.AfterCommit(
int RowsUpdated // Number of rows inserted or updated
int RowsInErrors // Number of rows that cannot be updated due to databas...
)
{
// Modifico la modalità di autosave del form a seconda della scelta
// dell'utente. Nel campo AutoSaveTypesPanelSetting è contenuto un valore
// appartenente alla lista valori AutoSaveTypes.
this.AutoSaveType := PanelSettings.AutoSaveTypesPanelSetting
//
// Mostro a video un messaggio che avvisa l'utente della modifica del
// comportamento dell'interfaccia
this.ShowMessage(INFO, FormatMessage(MSG Valore Della, Decode(
PanelSettings.AutoSaveTypesPanelSetting, AutoSaveTypes), ??, ??, ??, ??),
Empty String, C001, False)
}
- Un messaggio temporaneo viene cancellato dall'interfaccia non appena viene fatta una richiesta al server, cioé non appena l'utente utilizza un oggetto attivo o conferma i dati della videata.
- Un messaggio permanente rimane visibile finché non viene chiuso il form o finché non viene mostrato un altro messaggio con lo stesso codice.
- Il framework utilizza questa funzione per scrivere i messaggi relativi agli errori del pannello o ai messaggio informativi.
Ultima modifica: 25/10/2016 / Validità: da 6.5.2680