Condizioni di notifica
Evento notificato all'applicazione o a un componente quando qualcuno, applicazione o componente, ha inviato un messaggio tramite il metodo SendAppMessage:
Utilizzo consigliato
Normalmente l'evento viene utilizzato se si desidera scambiare messaggi tra applicazione e componenti. Per esempio l'evento può essere utilizzato per comunicare l'istanza del DocumentHelper a tutta la gerarchia per fare in modo che tutti, applicazione e componenti, utilizzino la stessa istanza di DocumentHelper. Per fare questo è sufficiente implementare l'evento in tutti i componenti, l'applicazione crea l'istanza di document helper e la invia tramite il metodo SendAppMessage.
Può anche essere utilizzato per "centralizzare" il log dell'applicazione. Tutti i componenti potrebbero inviare i loro messaggi e l'applicazione, quando li riceve, potrebbe scrivere su file o su database cosa è successo e quando.
Argomenti
Message | Nome del messaggio |
Parameter | E' un parametro di tipo oggetto che contiene le informazioni relative al messaggio inviato. Tale parametro è quello fornito al metodo SendAppMessage |
Esempio di codice
// An event fired by the application when it is initialized
// **************************************************************
event Application.Initialize()
{
DocumentHelper dh = new()
NPQ04788App.sendAppMessage("DocHelper", dh)
}
// **************************************************************
// Fired by the application and by a component when someone, application or component, used the SendAppMessage method
// **************************************************************
event Component1.OnAppMessage(
string Message // Message name
object Parameter // Object parameter that contains the info relevant to the message. This parameter is the same that was provided, by the sender, to the SendAppMessage method
)
{
if (Message == "DocHelper")
Component1.documentHelper = cast(Parameter)
}
Ultima modifica: 20/11/2020 / Validità: da 20.5.8000
- L'evento viene notificato anche a colui che ha inviato il messaggio tramite il metodo SendAppMessage.