Message Confirm Ex

funzione copia link

Scopo

Mostra un messaggio all'utente che richiede una conferma da parte sua. Questa funzione è equivalente alla funzione MessageConfirm a parte il fatto che ritorna un intero grazie al quale è possibile distinguere la risposta negativa dell'utente dal primo giro nel quale viene mostrato il messaggio all'utente.

Sintassi

int risposta := Applicazione.MessageConfirmEx(messaggio)

Argomenti

Messaggio	Testo del messaggio da mostrare
Opzioni	Utilizzato per configurare i pulsanti da mostrare, deve contenere le caption dei pulsanti separate dal ;.

Valore di ritorno

Viene ritornato Null quando il messaggio viene mostrato all'utente e True/False quando l'utente ha confermato o meno.

Dalla versione 11 è stata introdotta la possibilità di configurare i pulsanti mostrati utilizzando il parametro opzionale Opzioni; in questo caso il valore di ritorno è un numero intero rappresentante il pulsante premuto dall'utente, da 1 al numero di pulsanti.

Esempio di codice

// ************************************************************************
// Evento notificato dal pannello prima di eseguire un comando di pannello.
// ************************************************************************
event Videata.Pannello.OnCommand(
  int Command           // E' un numero intero che rappresenta il comando ...
  inout boolean Cancel  // Può essere impostato a True per cancellare il c...
  boolean UserOperation // E' un valore booleano che vale True se l'evento...
)
{
  // Se l'utente ha cliccato il bottone di salvataggio
  if Command = Update AND UserOperation
  {
    int OK := Applicazione.MessageConfirmEx(Sei sicuro di voler salvare?)
    //
    // Se l'utente non ha ancora risposto
    if IsNull(OK)
    {
      // Esco subito
      return
    }
    //
    // Se l'utente ha confermato
    if OK = True
    {
      // Salvo
      Pannello.UpdateData()
    }
    else
    {
      // Annullo
      Pannello.UndoChanges()
    }
  }
}

Esempio di Codice - 2

// **************************
// Procedere con l'esecuzione
// **************************
public void Test.Procedi()
{
  int i = NuovaApplicazioneWeb.messageConfirmEx("Procedere con l'esecuzione?"
           , "Si;No;Annulla")
  //
  if (isNull(i))
  {
    return
  }
  else
  {
    switch (i)
    {
      case 1:
         NuovaApplicazioneWeb.DTTLogMessage("premuto SI", ...)
      break
      case 2:
         NuovaApplicazioneWeb.DTTLogMessage("premuto NO", ...)
      break
      case 3:
         NuovaApplicazioneWeb.DTTLogMessage("premuto Annulla", ...)
      break
    }
  }

}

Fare riferimento alla funzione MessageConfirm per ulteriori informazioni.
Utilizzare la funzione IsNull per verificare se il risultato tornato è nullo.
In RD3, per poter mostrare del testo su più righe sarebbe necessario utilizzare il tag HTML </br>, ma per facilitare la portabilità delle applicazione da RD3 il sistema sostituisce automaticamente i \n con il tag HTML.
Dalla versione 16.0 è possibile configurare la classe CSS assegnata alla MessageConfirmEx, in modo da poterne personalizzare la visualizzazione (nota di rilascio).
Il parametro Opzioni è stato inserito in versione 11.5.

Ultima modifica: 22/09/2021 / Validità: da 9.9.3940