CTaskDialog::ShowDialog

Articolo
06/10/2015

Crea e visualizza CTaskDialog.

static INT_PTR ShowDialog(
   const CString& strContent,
   const CString& strMainInstruction,
   const CString& strTitle,
   int nIDCommandControlsFirst,
   int nIDCommandControlsLast,
   int nCommonButtons = TDCBF_YES_BUTTON | TDCBF_NO_BUTTON,
   int nTaskDialogOptions = TDF_ENABLE_HYPERLINKS | TDF_USE_COMMAND_LINKS,
   const CString& strFooter = _T("")
);

Parametri

[in] strContent
La stringa da utilizzare per il contenuto CTaskDialog.
[in] strMainInstruction
l'istruzione principale CTaskDialog.
[in] strTitle
Titolo della classe CTaskDialog.
[in] nIDCommandControlsFirst
ID stringa del primo comando.
[in] nIDCommandControlsLast
ID stringa dell'ultimo comando.
[in] nCommonButtons
Una maschera dei pulsanti da aggiungere a CTaskDialog.
[in] nTaskDialogOptions
Set di opzioni utilizzare per CTaskDialog.
[in] strFooter
La stringa da utilizzare come il piè di pagina.

Valore restituito

Un numero intero che corrisponde alla selezione è stata effettuata dall'utente.

Note

Questo metodo statico consente di creare un'istanza Classe CTaskDialog senza creare esplicitamente un oggetto CTaskDialog nel codice. Poiché non esiste alcun oggetto CTaskDialog, non è possibile chiamare altri metodi CTaskDialog se si utilizza questo metodo per visualizzare CTaskDialog all'utente.

Questo metodo crea pulsanti di comando utilizzando i dati del file di risorse dell'applicazione. La tabella di stringhe nel file di risorse sono disponibili diverse stringhe con ID stringa collegata. Questo metodo aggiunge un pulsante di comando per ciascuna voce valida nella tabella di stringhe tra nIDCommandControlsFirst e nCommandControlsLast, inclusi. Per questi pulsanti di comando, la stringa nella tabella di stringhe è la barra del titolo del controllo e ID stringa è l'id del controllo

Vedere CTaskDialog::SetOptions per un elenco di opzioni valide.

CTaskDialog viene chiusa quando l'utente seleziona un pulsante comune, un controllo di collegamento al comando, o chiude CTaskDialog. Il valore restituito è l'identificatore che indica quali l'utente chiude la finestra di dialogo.

Esempio

  // TODO: Replace the string below with the actual message to the user
    CString message("Important information to the user");
    // TODO: Replace the string below with the title of this project
    CString title("Project Title");

    CString emptyString;

    if (CTaskDialog::IsSupported())
    {
        CTaskDialog::ShowDialog(message, emptyString, title, 0, 0, 
            TDCBF_OK_BUTTON);
    }
    else
    {
        AfxMessageBox(message);
    }