Styles de boîte de dialogue

Le tableau suivant répertorie les styles de boîte de dialogue que vous pouvez spécifier lorsque vous créez une boîte de dialogue. Vous pouvez utiliser ces styles dans les appels aux fonctions CreateWindow et CreateWindowEx , dans le membre de style des structures DLGTEMPLATE et DLGTEMPLATEEX , et dans l’instruction d’une définition de boîte de dialogue dans un fichier de ressources.

Constante	Description
DS_3DLOOK	Obsolète. Le système applique automatiquement l’apparence tridimensionnelle aux boîtes de dialogue créées par les applications.
DS_ABSALIGN	Indique que les coordonnées de la boîte de dialogue sont des coordonnées d’écran. Si ce style n’est pas spécifié, les coordonnées sont des coordonnées clientes.
DS_CENTER	Centre la boîte de dialogue dans la zone de travail du moniteur qui contient la fenêtre propriétaire. Si aucune fenêtre propriétaire n’est spécifiée, la boîte de dialogue est centrée dans la zone de travail d’un moniteur déterminé par le système. La zone de travail est la zone qui n’est pas masquée par la barre des tâches ou les barres d’application.
DS_CENTERMOUSE	Centre la boîte de dialogue sur le curseur de la souris.
DS_CONTEXTHELP	Inclut un point d’interrogation dans la barre de titre de la boîte de dialogue. Lorsque l’utilisateur clique sur le point d’interrogation, le curseur devient un point d’interrogation avec un pointeur. Si l’utilisateur clique ensuite sur un contrôle dans la boîte de dialogue, celui-ci reçoit un message WM_HELP . Le contrôle doit passer le message à la procédure de boîte de dialogue, qui doit appeler la fonction à l’aide de la commande HELP_WM_HELP . L’application d’aide affiche une fenêtre contextuelle qui contient généralement de l’aide pour le contrôle. Notez que DS_CONTEXTHELP n’est qu’un espace réservé. Lorsque la boîte de dialogue est créée, le système recherche DS_CONTEXTHELP et, le cas échéant, ajoute WS_EX_CONTEXTHELP au style étendu de la boîte de dialogue. WS_EX_CONTEXTHELP ne peut pas être utilisé avec les styles WS_MAXIMIZEBOX ou WS_MINIMIZEBOX .
DS_CONTROL	Crée une boîte de dialogue qui fonctionne bien en tant que fenêtre enfant d’une autre boîte de dialogue, un peu comme une page dans une feuille de propriétés. Ce style permet à l’utilisateur de tabulation parmi les fenêtres de contrôle d’une boîte de dialogue enfant, d’utiliser ses touches d’accélérateur, et ainsi de suite.
DS_FIXEDSYS	Fait en sorte que la boîte de dialogue utilise le SYSTEM_FIXED_FONT au lieu du SYSTEM_FONT par défaut. Il s’agit d’une police monospace compatible avec la police système dans les versions 16 bits de Windows antérieures à 3.0.
DS_LOCALEDIT	S’applique uniquement aux applications 16 bits. Ce style permet aux contrôles de modification de la boîte de dialogue d’allouer de la mémoire à partir du segment de données de l’application. Sinon, les contrôles de modification allouent le stockage à partir d’un objet de mémoire globale.
DS_MODALFRAME	Crée une boîte de dialogue avec un cadre de boîte de dialogue modal qui peut être combiné avec une barre de titre et un menu de fenêtre en spécifiant les styles WS_CAPTION et WS_SYSMENU .
DS_NOFAILCREATE	Crée la boîte de dialogue même si des erreurs se produisent, par exemple, si une fenêtre enfant ne peut pas être créée ou si le système ne peut pas créer un segment de données spécial pour un contrôle d’édition.
DS_NOIDLEMSG	Supprime WM_ENTERIDLE messages que le système enverrait autrement au propriétaire de la boîte de dialogue pendant que la boîte de dialogue s’affiche.
DS_SETFONT	Indique que l’en-tête du modèle de boîte de dialogue (standard ou étendu) contient des données supplémentaires spécifiant la police à utiliser pour le texte dans la zone cliente et les contrôles de la boîte de dialogue. Si possible, le système sélectionne une police en fonction des données de police spécifiées. Le système transmet un handle à la police à la boîte de dialogue et à chaque contrôle en leur envoyant le message WM_SETFONT . Pour obtenir des descriptions du format de ces données de police, consultez DLGTEMPLATE et DLGTEMPLATEEX. Si ni DS_SETFONT ni DS_SHELLFONT n’est spécifié, le modèle de boîte de dialogue n’inclut pas les données de police.
DS_SETFOREGROUND	Oblige le système à utiliser la fonction SetForegroundWindow pour placer la boîte de dialogue au premier plan. Ce style est utile pour les boîtes de dialogue modales qui nécessitent une attention immédiate de la part de l’utilisateur, que la fenêtre propriétaire soit ou non la fenêtre de premier plan. Le système restreint les processus qui peuvent définir la fenêtre de premier plan. Pour plus d’informations, consultez Fenêtres de premier plan et d’arrière-plan.
DS_SHELLFONT	Indique que la boîte de dialogue doit utiliser la police système. Le membre de police du modèle de boîte de dialogue étendu doit être défini sur MS Shell Dlg. Sinon, ce style n’a aucun effet. Il est également recommandé d’utiliser la ressource DIALOGEX plutôt que la ressource DIALOG. Pour plus d’informations, consultez Polices de boîte de dialogue. Le système sélectionne une police à l’aide des données de police spécifiées dans les membres pointize, weight et italic . Le système transmet un handle à la police à la boîte de dialogue et à chaque contrôle en leur envoyant le message WM_SETFONT . Pour obtenir des descriptions du format de ces données de police, consultez DLGTEMPLATEEX. Si ni DS_SHELLFONT ni DS_SETFONT n’est spécifié, le modèle de boîte de dialogue étendu n’inclut pas les données de police.
DS_SYSMODAL	Ce style est obsolète et est inclus pour la compatibilité avec les versions 16 bits de Windows. Si vous spécifiez ce style, le système crée la boîte de dialogue avec le style WS_EX_TOPMOST . Ce style n’empêche pas l’utilisateur d’accéder à d’autres fenêtres sur le bureau. Ne combinez pas ce style avec le style DS_CONTROL .

Spécifications

Condition requise	Valeur
Client minimal pris en charge	Windows 2000 Professionnel [applications de bureau uniquement]
Serveur minimal pris en charge	Windows 2000 Server [applications de bureau uniquement]
En-tête	Winuser.h (inclure Windows.h)