CTaskDialog::SetCommonButtonOptions

Artículo
06/10/2015

Actualizar un subconjunto de botones comunes que se habilitarán y exigir la elevación de UAC.

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

Parámetros

[in] nDisabledButtonMask
Una máscara para los botones comunes al deshabilitar.
[in] nElevationButtonMask
una máscara para los botones comunes que requieren la elevación.

Comentarios

Puede establecer los botones comunes disponible para una instancia de CTaskDialog Class utilizando el constructor CTaskDialog::CTaskDialog y el método CTaskDialog::SetCommonButtons. CTaskDialog::SetCommonButtonOptions no admite agregar nuevos botones comunes.

Si utiliza este método para deshabilitar o para elevar un botón común que no está disponible para este CTaskDialog, este método produce una excepción mediante la macro de ENSURE (MFC) .

Este método permite cualquier botón disponible para CTaskDialog pero no está en nDisabledButtonMask, incluso si se deshabilitó anteriormente. este método trata la elevación de la misma manera: registra los botones comunes como no requiriendo la elevación si el botón común está disponible pero no incluido en nElevationButtonMask.

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