CTaskDialog::SetCommonButtonOptions

Article
06/10/2015

Met à jour un sous-ensemble de boutons communs à activer et pour exiger élévation du contrôle de compte d'utilisateur.

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

Paramètres

[in] nDisabledButtonMask
Un masque pour le communs boutons pour désactiver.
[in] nElevationButtonMask
Un caractère générique pour les boutons communs qui requièrent l'élévation.

Notes

Vous pouvez définir les boutons sont disponibles à une instance de CTaskDialog, classe à l'aide de le constructeur CTaskDialog::CTaskDialog et de la méthode CTaskDialog::SetCommonButtons. CTaskDialog::SetCommonButtonOptions ne prend pas en charge l'ajout de nouveaux boutons courants.

Si vous utilisez cette méthode pour désactiver ou élever un bouton) qui est pas disponible pour cet CTaskDialog, les lève de cette méthode une exception à l'aide de la macro d' GARANTISSEZ (MFC) .

Cette méthode permet à n'importe quel bouton qui est disponible à CTaskDialog mais n'est pas dans nDisabledButtonMask, même si elle a été précédemment désactivée. Cette méthode traite l'élévation d'une manière similaire : elle enregistre les boutons communs comme ne nécessitant pas l'élévation si le bouton courant est disponible mais pas inclus dans nElevationButtonMask.

Exemple

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