CTaskDialog::ShowDialog

Artikel
02/26/2013

Erstellt und zeigt CTaskDialog an.

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("")
);

Parameter

[in] strContent
Die für den Inhalt CTaskDialog zu verwenden, Zeichenfolge.
[in] strMainInstruction
Die Anweisung CTaskDialog.
[in] strTitle
Der Titel der CTaskDialog.
[in] nIDCommandControlsFirst
Die Zeichenfolgen-ID des ersten Befehls.
[in] nIDCommandControlsLast
Die Zeichenfolgen-ID des letzten Befehls.
[in] nCommonButtons
Eine Maske der Schaltflächen, CTaskDialog hinzuzufügen.
[in] nTaskDialogOptions
Der Satz von Optionen, die für CTaskDialog zu verwenden.
[in] strFooter
Die als die Fußzeile zu verwenden, Zeichenfolge.

Rückgabewert

Eine ganze Zahl, die die Auswahl entspricht, wurde durch den Benutzer.

Hinweise

Diese statische Methode ermöglicht es Ihnen, eine Instanz CTaskDialog-Klasse zu erstellen, ohne ein CTaskDialog-Objekt explizit im Code zu erstellen.Da es kein CTaskDialog-Objekt gibt, können Sie keine anderen Methoden CTaskDialog aufrufen, wenn Sie diese Methode verwenden, um dem Benutzer CTaskDialog anzuzeigen.

Diese Methode erstellt Befehlsschaltflächensteuerelemente, indem Daten aus der Ressourcendatei der Anwendung verwendet.Die Zeichenfolgentabelle in der Ressourcendatei besitzt mehrere Zeichenfolgen mit zugeordneten Zeichenfolge IDs.Diese Methode fügt ein Ein Steuerelement für Befehlsschaltflächen für jeden gültigen Eintrag in der Zeichenfolgentabelle zwischen nIDCommandControlsFirst und nCommandControlsLast hinzu, liegt.Für diese Befehlsschaltflächensteuerelemente ist die Zeichenfolge in der Zeichenfolgentabelle die Beschriftung des Steuerelements und die Zeichenfolgen-ID sind die ID des Steuerelements

Siehe CTaskDialog::SetOptions für eine Liste von gültigen Optionen.

CTaskDialog wird abgeschlossen, wenn der Benutzer eine allgemeine Schaltfläche, ein Befehlslink-steuerelement auswählt oder CTaskDialog enthält.Der Rückgabewert ist der Bezeichner, der angibt, wie der Benutzer das Dialogfeld geschlossen hat.

Beispiel

    // 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);
    }