CTaskDialog::LoadCommandControls

2013-03-04

Ajoute des contrôles de bouton de commande à l'aide de les données de la table de chaînes.

void LoadCommandControls(
   int nIDCommandControlsFirst,
   int nIDCommandControlsLast
);

Paramètres

[in] nIDCommandControlsFirst
L'ID de chaîne de la première commande.
[in] nIDCommandControlsLast
L'ID de chaîne de la dernière commande.

Notes

Cette méthode crée des contrôles de bouton de commande à l'aide de les données du fichier de ressources de votre application.La table de chaînes dans le fichier de ressources a plusieurs chaînes avec les ID associés de chaîne.Les nouveaux contrôles bouton de commande ajoutés à l'aide de cette méthode utilise la chaîne pour la légende du contrôle et l'ID de chaîne pour l'ID du contrôleLa plage des chaînes sélectionnées est fourni par nIDCommandControlsFirst et nCommandControlsLast, inclus.Si une entrée vide de la plage, la méthode n'ajoute pas un contrôle bouton de commande pour cette entrée.

Par défaut, les nouveaux contrôles bouton de commande sont activés et ne nécessitent pas l'élévation.

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, 
    TDCBF_YES_BUTTON | TDCBF_NO_BUTTON | TDCBF_CANCEL_BUTTON );

taskDialog.AddCommandControl(201, L"First command button control");
taskDialog.AddCommandControl(202, L"Second command button control");
taskDialog.AddCommandControl(203, L"Third command button control");

// Show the CTaskDialog and remember how the user closed it.
int selection = taskDialog.DoModal();

switch(selection)
{
case 201:
    // TODO: Place processing here for the first 
    // command button control.
    break;

case 202:
    // TODO: Place processing here for the second 
    // command button control.
    break;

case 203:
    // TODO: Place processing here for the third 
    // command button control.
    break;

default:
    break;
}

// Remove all the command controls so that we can use the same task
// dialog with new command button controls.
taskDialog.RemoveAllCommandControls();

taskDialog.AddCommandControl(301, 
    L"New first command button control");
taskDialog.AddCommandControl(302, 
    L"New second command button control should require elevation",
    TRUE, TRUE);
taskDialog.AddCommandControl(303, 
    L"New third command button control should be disabled");

// Change the default command button control
taskDialog.SetDefaultCommandControl(302);

// Make sure the third option is disabled.
if (taskDialog.IsCommandControlEnabled(303))
{
    taskDialog.SetCommandControlOptions(303, FALSE);
}

taskDialog.DoModal();

switch(taskDialog.GetSelectedCommandControlID())
{
case 301:
    // TODO: Place processing here for new first 
    // command button control.
    break;

case 302:
    // TODO: Place processing here for new second 
    // command button control.
    break;

case 303:
    // TODO: Place processing here for the new third 
    // command button control.
    break;

default:
    break;
}

// Remove all the command button controls and add new ones from
// the string table resource.
taskDialog.RemoveAllCommandControls();
taskDialog.LoadCommandControls(1001, 1005);

Configuration requise

en-tête : afxtaskdialog.h

Voir aussi

Référence

De classe CTaskDialog

Graphique de la hiérarchie

CTaskDialog::AddCommandControl

CTaskDialog::SetCommandControlOptions

CTaskDialog::RemoveAllCommandControls

Partager via