CTaskDialog::ShowDialog

Artigo
02/25/2013

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

Parâmetros

[in] strContent
A cadeia de caracteres a ser usado para o conteúdo de CTaskDialog.
[in] strMainInstruction
a instrução principal de CTaskDialog.
[in] strTitle
o título de CTaskDialog.
[in] nIDCommandControlsFirst
A identificação de cadeia de caracteres do primeiro comando.
[in] nIDCommandControlsLast
A identificação de cadeia de caracteres de comando do último.
[in] nCommonButtons
Uma máscara dos botões para adicionar a CTaskDialog.
[in] nTaskDialogOptions
O conjunto de opções para usar CTaskDialog.
[in] strFooter
A cadeia de caracteres para usar como o rodapé.

Valor de retorno

Um inteiro que corresponda à seleção fez pelo usuário.

Comentários

Este método estático permite que você crie uma instância de Classe de CTaskDialog sem criar explicitamente um objeto de CTaskDialog no seu código.Porque não há nenhum objeto de CTaskDialog , você não pode chamar quaisquer outros métodos de CTaskDialog se você usar esse método para mostrar CTaskDialog para o usuário.

Este método cria controles de botão de comando usando dados do arquivo de recurso do aplicativo.A tabela de cadeia de caracteres no arquivo de recurso tem várias cadeias de caracteres com os IDs associados de cadeia de caracteres.Este método adiciona um controle de botão de comando para cada entrada válida na tabela de cadeia de caracteres entre nIDCommandControlsFirst e nCommandControlsLast, inclusive.Para esses controles de botão de comando, a cadeia de caracteres na tabela de cadeia de caracteres é a legenda do controle e a identificação de cadeia de caracteres é a identificação do controle

Consulte CTaskDialog::SetOptions para obter uma lista de opções válidos.

CTaskDialog fecha quando o usuário seleciona um botão), um controle de link de comando, ou fecha CTaskDialog.o valor de retorno é o identificador que indica como o usuário fechou a caixa de diálogo.

Exemplo

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