CTaskDialog::SetCommonButtonOptions

项目
03/01/2013

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

参数

[in] nDisabledButtonMask
常见的掩码按禁用。
[in] nElevationButtonMask
需要提升权限的常见按钮掩码。

备注

可以设置常见按钮可用于 CTaskDialog类选件的实例通过使用构造函数 CTaskDialog::CTaskDialog 和方法 CTaskDialog::SetCommonButtons。 CTaskDialog::SetCommonButtonOptions 不支持添加新的常见按钮。

如果使用此方法禁用或提升为此 CTaskDialog不可用的常见按钮，此方法引发使用确保(MFC) 宏的异常。

此方法启用对 CTaskDialog 可用的所有按钮，但不在 nDisabledButtonMask，因此，即使它以前被禁用。此方法以类似方式将提升:，如果常见按钮才可用，但不包括在的 nElevationButtonMask，它记录常见按钮为不需要提升权限。

示例

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