Compartir a través de


CTaskDialog::SetCommonButtons

Agregue los botones comunes a CTaskDialog.

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

Parámetros

  • [in] nButtonMask
    Una máscara de botones a agregar a CTaskDialog.

  • [in] nDisabledButtonMask
    Una máscara de botones a deshabilitar.

  • [in] nElevationButtonMask
    Una máscara de botones que requieren la elevación.

Comentarios

No puede llamar a este método después de que la ventana de presentación para esta instancia de CTaskDialog Class creado. Si lo hace, este método produce una excepción.

Los botones indicados por nButtonMask reemplaza cualquier botón común agregado a CTaskDialog. Sólo los botones indicados en nButtonMask están disponibles.

Si nDisabledButtonMask o nElevationButtonMask contiene un botón que no está en nButtonMask, este método produce una excepción mediante la macro de ENSURE (MFC) .

de forma predeterminada, todos los botones comunes se habilitan y no requieren la elevación.

Ejemplo

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

Requisitos

encabezado: afxtaskdialog.h

Vea también

Referencia

CTaskDialog Class

Gráfico de jerarquías

CTaskDialog::SetCommonButtonOptions