CTaskDialog::SetCommonButtonOptions

Článek
03/04/2013

Aktualizuje podmnožiny běžných tlačítek povolit a vyžadovat zvýšení oprávnění nástroje Řízení uživatelských účtů.

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

Parametry

[v]nDisabledButtonMask
Maska pro běžné tlačítka zakázat.
[v]nElevationButtonMask
Maska běžných tlačítek, která vyžadují zvýšení.

Poznámky

Instance můžete nastavit společné tlačítka k dispozici Třída CTaskDialog pomocí konstruktoru CTaskDialog::CTaskDialog a CTaskDialog::SetCommonButtons.CTaskDialog::SetCommonButtonOptionsnepodporuje přidání nových běžných tlačítek.

Použití této metody zakázat nebo zvyšovat společné tlačítko, které není k dispozici pro tento CTaskDialog , tato metoda vyvolá výjimku pomocí ZAJIŠTĚNÍ (MFC) makro.

Tato metoda umožňuje libovolné tlačítko, který je k dispozici CTaskDialog , ale není v nDisabledButtonMask , i když byla předtím zakázána.Tato metoda považuje zvýšení podobným způsobem: zaznamenává běžných tlačítek není požadavek zvýšení, pokud společný tlačítko je k dispozici, ale nejsou zahrnuty v nElevationButtonMask .

Příklad

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