Introduzione
Esiste la possibilità di programmare e visualizzare proprie finestre di dialogo e finestre di conferma. Queste finestre consentono di interagire con l'utente dell'Add-In.
API
La tabella seguente elenca i metodi per leggere "MessageBox" da TIA Portal:
|
Metodo |
Descrizione |
|---|---|
|
MessageBox GetService<MessageBoxProvider>() |
È possibile accedere al metodo "GetService<MessageBoxProvider>()" con l'oggetto "TiaPortal". Il metodo restituisce "MessageBox", il cui valore può essere utilizzato per visualizzare le finestre di dialogo e le finestre di conferma in TIA Portal. |
La seguente tabella elenca i metodi di "MessageBox":
|
Metodo |
Descrizione |
|---|---|
|
void ShowNotification(NotificationIcon notificationIcon, string caption, string message) |
Viene visualizzata una semplice finestra di dialogo che può essere confermata con "OK".
|
|
void ShowNotification(NotificationIcon notificationIcon, string caption, string message, string detailedMessage) |
Viene visualizzata una finestra di dialogo con delle informazioni aggiuntive che può essere confermata con "OK".
|
|
ConfirmationResult ShowConfirmation(ConfirmationIcon icon, string caption, string message, ConfirmationChoices choices, ConfirmationResult defaultChoice) |
Viene visualizzata una semplice finestra di conferma. È possibile definire quali pulsanti dovranno essere visualizzati.
|
|
ConfirmationResult ShowConfirmation(ConfirmationIcon icon, string caption, string message, string detailedMessage, ConfirmationChoices choices, ConfirmationResult defaultChoice) |
Viene visualizzata una semplice finestra di conferma contenente delle informazioni aggiuntive. È possibile definire quali pulsanti dovranno essere visualizzati.
|
Esempio di codice per la visualizzazione di un messaggio in una finestra di dialogo
L'esempio seguente illustra come visualizzare una finestra di dialogo con informazioni aggiuntive:
//...
var messageBox = m_TiaPortal.GetService<MessageBoxProvider>;
messageBox.ShowNotification(NotificationIcon.Information, "Add-In Notification", "Pop up from Context Menu Add-In", "Pop up called from Add-In. Please click Ok to continue.");
//...
L'esempio seguente illustra come visualizzare una semplice finestra di dialogo senza informazioni aggiuntive:
//...
var messageBox = m_TiaPortalGetService<MessageBoxProvider>;
messageBox.ShowNotification(NotificationIcon.Warning, "Add-In Notification", "Pop up from Context Menu Add-In");
//...
Esempio di codice per la visualizzazione di una finestra di conferma
L'esempio seguente illustra come visualizzare una finestra di conferma con informazioni aggiuntive:
//...
var messageBox = m_TiaPortalGetService<MessageBoxProvider>;
ConfirmationResult result = messageBox.ShowConfirmation(ConfirmationIcon.General,"Add-In Confirmation","Confirm Pop up from Add-In", "Confirm Pop up called from Add-In",
ConfirmationChoices.Ok | ConfirmationChoices.Cancel, ConfirmationResult.Ok);
if (result == ConfirmationResult.Ok)
{
//...
}
else
{
//...
}
//...
L'esempio seguente illustra come visualizzare una semplice finestra di conferma senza informazioni aggiuntive:
//...
var messageBox = m_TiaPortal.GetService<MessageBoxProvider>;
ConfirmationResult result = messageBox.ShowConfirmation(ConfirmationIcon.General,"Add-In Confirmation","Confirm Pop up from Add-In",
ConfirmationChoices.Ok | ConfirmationChoices.Cancel, ConfirmationResult.Cancel);
if (result == ConfirmationResult.Ok)
{
//...
}
else
{
//...
}
//...
Vedere anche