CTaskDialog::SetCommonButtonOptions

Articolo
02/19/2013

Aggiorna un sottoinsieme dei pulsanti comuni per attivare e richiedere l'elevazione di controllodell'account utente.

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

Parametri

[in] nDisabledButtonMask
Una maschera per il comune i pulsanti per disabilitare.
[in] nElevationButtonMask
Una maschera per i pulsanti comuni che richiedono l'elevazione.

Note

È possibile impostare i pulsanti comuni disponibili in un'istanza Classe CTaskDialog utilizzando il costruttore CTaskDialog::CTaskDialog e il metodo CTaskDialog::SetCommonButtons.CTaskDialog::SetCommonButtonOptions non supporta l'aggiunta di nuovi pulsanti comuni.

Se si utilizza questo metodo per disabilitare o elevare un pulsante comune non disponibile per questo CTaskDialog, esso genera un'eccezione utilizzando la macro ASSICURI (MFC).

Questo metodo consente il pulsante disponibile a CTaskDialog ma non è in nDisabledButtonMask, anche se era stato disabilitato.Questo metodo gestisce l'elevazione in modo analogo: registra i pulsanti comuni quali non si richiede l'elevazione se il pulsante comune è disponibile ma non incluso in nElevationButtonMask.

Esempio

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