CTaskDialog::ShowDialog

Článek
03/04/2013

Vytvoří a zobrazí 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("")
);

Parametry

[v]strContent
Řetězec pro obsah CTaskDialog .
[v]strMainInstruction
Hlavní instrukce o CTaskDialog .
[v]strTitle
Název CTaskDialog .
[v]nIDCommandControlsFirst
Řetězec ID první příkaz.
[v]nIDCommandControlsLast
Řetězec ID poslední příkaz.
[v]nCommonButtons
Maska tlačítka Přidat CTaskDialog .
[v]nTaskDialogOptions
Nastavení voleb pro použití CTaskDialog .
[v]strFooter
Řetězec jako zápatí.

Vrácená hodnota

Celé číslo, které odpovídá výběru provedené uživatelem.

Poznámky

Tato statická metoda umožňuje vytvořit instanci Třída CTaskDialog bez vytvoření explicitně CTaskDialog objektu v kódu.Protože neexistuje žádné CTaskDialog objektu nelze volat jakékoliv jiné metody CTaskDialog Pokud tuto metodu použít k zobrazení CTaskDialog uživateli.

Tato metoda vytvoří ovládací prvky příkazového tlačítka pomocí dat ze zdrojového souboru aplikace.Tabulky řetězců v souboru prostředků má několik řetězců s ID přidružené řetězec.Tato metoda přidá příkazové tlačítko pro každou platnou položku v tabulce řetězců mezi nIDCommandControlsFirst a nCommandControlsLast , včetně.Pro tyto ovládací prvky příkazového tlačítka řetězec v tabulce řetězců je titulek ovládacího prvku, a řetězec ID ID ovládacího prvku.

Viz CTaskDialog::SetOptions seznam obsahuje platné možnosti.

CTaskDialog Ukončí, když uživatel vybere společné tlačítko, ovládací prvek link příkazu nebo zavře CTaskDialog .Vrácená hodnota je identifikátor, který označuje, jak uživatele dialogové okno zavřeli.

Příklad

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