Condividi tramite


CTaskDialog::SetCommonButtons

Aggiungere pulsanti comuni a CTaskDialog.

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

Parametri

  • [in] nButtonMask
    Una maschera dei pulsanti da aggiungere a CTaskDialog.

  • [in] nDisabledButtonMask
    Una maschera dei pulsanti per disabilitare.

  • [in] nElevationButtonMask
    Una maschera dei pulsanti che richiedono l'elevazione.

Note

Non è possibile chiamare questo metodo dopo la finestra per questa istanza Classe CTaskDialog viene creata. Se è, il metodo genera un'eccezione.

I pulsanti indicati da nButtonMask eseguono l'override di tutti i pulsanti comuni precedentemente aggiunti a CTaskDialog. Solo i pulsanti visualizzati in nButtonMask sono disponibili.

Se nDisabledButtonMask o nElevationButtonMask contiene un pulsante non in nButtonMask, esso genera un'eccezione utilizzando la macro ENSURE (MFC).

Per impostazione predefinita, tutti i pulsanti comuni sono attivati e non richiedono l'elevazione.

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

Requisiti

intestazione: afxtaskdialog.h

Vedere anche

Riferimenti

Classe CTaskDialog

Grafico delle gerarchie

CTaskDialog::SetCommonButtonOptions