À propos des boîtes de dialogue de tâche
Une boîte de dialogue de tâche est une boîte de dialogue qui peut être utilisée pour afficher des informations et recevoir une entrée simple de l’utilisateur. Comme une boîte de message, elle est mise en forme par le système d’exploitation en fonction des paramètres que vous définissez. Toutefois, une boîte de dialogue de tâche a beaucoup plus de fonctionnalités qu’une boîte de message.
Notes
Les boîtes de dialogue de tâche nécessitent le modèle d’appartement à thread unique (STA).
Parties d’une boîte de dialogue de tâche
Une boîte de dialogue de tâche se compose de plusieurs éléments, dont la plupart sont facultatifs. L’illustration suivante montre les différentes parties d’une boîte de dialogue de tâche.
Dans l’illustration suivante, l’utilisateur a cliqué sur le bouton à côté du texte de contrôle réduit, ce qui entraîne l’affichage de texte de remplacement dans le pied de page.
Les illustrations montrent les éléments suivants :
| Élément | Description | MEMBRE TASKDIALOGCONFIG |
|---|---|---|
| Titre de fenêtre | Légende de la fenêtre. | pszWindowTitle |
| Icône principale | Grande icône qui indique l’objectif de la boîte de dialogue de tâche. | hMainIcon ou pszMainIcon |
| Instruction principale | Texte principal. | pszMainInstruction |
| Contenu | Texte supplémentaire. | pszContent |
| Barre de progression | Barre animée qui montre la progression d’une tâche. | dwFlags |
| Cases d’option | Options définies par l’application pour l’utilisateur. | pRadioButtons |
| Bouton personnalisé | Bouton qui n’est pas l’un des boutons courants. Il peut s’agir d’un bouton normal ou, comme indiqué dans l’illustration, d’un lien de commande avec jusqu’à deux lignes de texte. | pButtons |
| Bouton Développer/réduire | Bouton qui peut être utilisé pour basculer entre le texte du contrôle réduit défini par l’application (par exemple, « Afficher plus de détails ») et le texte du contrôle développé, qui peut être sur deux lignes ou plus. Lorsque le texte du contrôle est développé, le texte supplémentaire dans pszExpandedInformation s’affiche également, soit après le texte de contenu, soit (comme indiqué dans la deuxième illustration) dans le pied de page. | pszCollapsedControlText et pszExpandedControlText |
| Zone de case activée de vérification | Case à cocher, accompagnée d’un texte défini par l’application, pour des choix simples tels que « Ne plus afficher cette boîte de dialogue ». | pszVerificationText |
| Icône de pied de page | Petite icône qui indique l’objectif du texte de pied de page. | hFooterIcon ou pszFooterIcon |
| Texte du pied de page | Texte supplémentaire. Dans les illustrations, le texte contient un lien hypertexte. | pszFooter |
| Bouton Commun | Un bouton standard ; dans les illustrations, le bouton OK. | dwCommonButtons |