Compartilhar via


CTaskDialog::SetCommonButtons

Adiciona os botões comuns a CTaskDialog.

void SetCommonButtons(
   int nButtonMask,
   int nDisabledButtonMask = 0,
   int nElevationButtonMask = 0
);

Parâmetros

  • [in] nButtonMask
    Uma máscara dos botões para adicionar a CTaskDialog.

  • [in] nDisabledButtonMask
    Uma máscara dos botões para desativar.

  • [in] nElevationButtonMask
    Uma máscara de botões que exigem a elevação.

Comentários

Você não pode chamar este método após a janela de exibição para essa instância de Classe de CTaskDialog é criada.Se você fizer isso, este método gera uma exceção.

Os botões indicados por nButtonMask substituem os botões comuns a CTaskDialogadicionados anteriormente.Somente os botões indicados em nButtonMask estão disponíveis.

Se nDisabledButtonMask ou nElevationButtonMask contêm um botão que não esteja em nButtonMask, este método gera uma exceção usando a macro de GARANTIR (MFC) .

Por padrão, todos os botões comuns são ativados e não requerem o elevação.

Exemplo

// TODO: Replace the strings below with the appropriate message, 
// main instruction, and dialog title
CString message("This is an important message to the user.");
CString mainInstruction("Important!\nPlease read!");
CString title("Alert Dialog");

CTaskDialog taskDialog(message, mainInstruction, title);

// Create a button mask.
int buttons = TDCBF_OK_BUTTON | TDCBF_CANCEL_BUTTON;
buttons |= TDCBF_RETRY_BUTTON | TDCBF_CLOSE_BUTTON;

taskDialog.SetCommonButtons(buttons);

// Disable the close button and make the retry button require 
// elevation.
taskDialog.SetCommonButtonOptions(TDCBF_CLOSE_BUTTON, 
    TDCBF_RETRY_BUTTON);

taskDialog.DoModal();

Requisitos

Cabeçalho: afxtaskdialog.h

Consulte também

Referência

Classe de CTaskDialog

Gráfico de hierarquia

CTaskDialog::SetCommonButtonOptions