通过

CTaskDialog::SetCommonButtons

  • 项目

添加常见按钮。CTaskDialog。

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

参数

  • [in] nButtonMask
    添加按钮的掩码到 CTaskDialog。

  • [in] nDisabledButtonMask
    禁用的按钮掩码。

  • [in] nElevationButtonMask
    需要提升按钮掩码。

备注

在 CTaskDialog类选件 的此实例上显示窗口创建后，将无法调用此方法。 否则，此方法将引发异常。

nButtonMask 表示的按钮会重写所有常见的按钮先前添加到 CTaskDialog。 在 nButtonMask 指示的按钮仅可用。

如果 nDisabledButtonMask 或 nElevationButtonMask 包含不在 nButtonMask的按钮，此方法将引发使用 确保(MFC) 宏的异常。

默认情况下，所有常见的按钮均处于启用状态并且不需要提升。

示例

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

要求

标头: afxtaskdialog.h

请参见

参考

CTaskDialog类选件

层次结构图

CTaskDialog::SetCommonButtonOptions