CTaskDialog::SetCommonButtonOptions

Artigo
02/25/2013

Atualiza um subconjunto dos botões comuns a ser ativados e necessário para elevar UAC.

void SetCommonButtonOptions(
   int nDisabledButtonMask,
   int nElevationButtonMask = 0
);

Parâmetros

[in] nDisabledButtonMask
Uma máscara para um comum botões para desativar.
[in] nElevationButtonMask
Uma máscara para os botões comuns que requerem elevação.

Comentários

Você pode definir os botões comuns disponíveis para uma instância de Classe de CTaskDialog usando o construtor CTaskDialog::CTaskDialog e o método CTaskDialog::SetCommonButtons.CTaskDialog::SetCommonButtonOptions não suporta adicionar novos botões comuns.

Se você usar esse método para desativar ou elevar um botão comuns que não está disponível para este CTaskDialog, este método gera uma exceção usando a macro de GARANTIR (MFC) .

Esse método permite que qualquer botão que seja acessível a CTaskDialog mas não está em nDisabledButtonMask, mesmo se foi desativado anteriormente.Este método trata a elevação de maneira semelhante: grava os botões comuns como sem exigir a elevação se o botão é comum disponível mas não incluído em nElevationButtonMask.

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