CTaskDialog::SetCommonButtonOptions

아티클
02/21/2013

일반적인 단추 활성화 하 고 UAC 권한 상승을 요구의 하위 집합을 업데이트 합니다.

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

매개 변수

[in] nDisabledButtonMask
일반적인 단추를 비활성화 하는 마스크입니다.
[in] nElevationButtonMask
권한 상승이 필요한 일반적인 단추에 대 한 마스크입니다.

설명

인스턴스를 사용할 수 있는 일반적인 단추를 설정할 수 있습니다는 CTaskDialog 클래스 생성자를 사용 하 여 CTaskDialog::CTaskDialog 메서드와 CTaskDialog::SetCommonButtons.CTaskDialog::SetCommonButtonOptions일반적인 새 단추를 추가할 수 없습니다.

승격에 사용할 수 있는 일반적인 단추 또는 비활성화 하려면이 메서드를 사용 하는 경우 CTaskDialog를 사용 하 여이 메서드에서 예외가 throw는 (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();