Lire en anglais

Partager via


À 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.

capture d’écran d’une fenêtre montrant différents boutons, dont un en regard du texte de contrôle réduit

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.

capture d’écran de la fenêtre précédente, mais avec deux lignes de texte de contrôle développé

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