Styles utilisés par MFC

  • Article

Utilisez les indicateurs de style suivants pour spécifier l’apparence et le comportement de fenêtre ou de contrôle lorsque vous créez l’objet MFC correspondant. Dans la plupart des cas, ces styles sont définis dans le dwStyle paramètre de la fonction de classe Create .

Styles de bouton

Les styles de bouton s’appliquent aux objets, tels que les cases d’option, les cases à CButton Class cocher et les boutons push. Spécifiez une combinaison de styles dans le dwStyle paramètre de CButton::Create. Pour plus d’informations sur les styles de bouton dans Windows, consultez Styles de bouton (Windows).

Types de boutons

Le tableau suivant répertorie les types de boutons. Vous pouvez éventuellement choisir l’une des options suivantes. Si vous ne spécifiez pas de type de bouton, la valeur par défaut est BS_PUSHBUTTON.

Type Description
BS_3STATE Crée un bouton de case à cocher avec trois états : BST_CHECKED, BST_INDETERMINATEet BST_UNCHECKED. Cliquer sur le bouton envoie une BN_CLICKED notification à la fenêtre propriétaire, mais ne modifie pas l’état du bouton. Par défaut, le texte associé s’affiche à droite de la case à cocher. Pour afficher du texte à gauche de la case à cocher, utilisez le ou BS_RIGHTBUTTON le BS_LEFTTEXT style.
BS_AUTO3STATE Crée un bouton de case à cocher avec trois états : BST_CHECKED, BST_INDETERMINATEet BST_UNCHECKED. Cliquer sur le bouton envoie une BN_CLICKED notification à la fenêtre propriétaire et modifie l’état du bouton. Le bouton indique le cycle dans l’ordre de BST_CHECKED, BST_INDETERMINATEet BST_UNCHECKED. Par défaut, le texte associé s’affiche à droite de la case à cocher. Pour afficher du texte à gauche de la case à cocher, utilisez le ou BS_RIGHTBUTTON le BS_LEFTTEXT style.
BS_AUTOCHECKBOX Crée un bouton de case à cocher avec deux états : BST_CHECKED et BST_UNCHECKED. Cliquer sur le bouton envoie une BN_CLICKED notification à la fenêtre propriétaire et modifie l’état du bouton. Par défaut, le texte associé s’affiche à droite de la case à cocher. Pour afficher du texte à gauche de la case à cocher, utilisez le ou BS_RIGHTBUTTON le BS_LEFTTEXT style.
BS_AUTORADIOBUTTON Crée une case d’option avec deux états : BST_CHECKED et BST_UNCHECKED. Les cases d’option sont généralement utilisées dans des groupes, chaque groupe ayant un maximum d’une option activée à la fois. En cliquant sur le bouton, une BN_CLICKED notification est envoyée à la fenêtre propriétaire, définit l’état de la case BST_CHECKEDd’option cliquée sur , et définit les états de toutes les autres cases d’option dans le groupe BST_UNCHECKEDde boutons sur . Par défaut, le texte associé s’affiche à droite de la case d’option. Pour afficher du texte à gauche de la case d’option, utilisez le ou BS_RIGHTBUTTON le BS_LEFTTEXT style.
BS_CHECKBOX Crée un bouton de case à cocher avec deux états : BST_CHECKED et BST_UNCHECKED. Cliquer sur le bouton envoie une BN_CLICKED notification à la fenêtre propriétaire, mais ne modifie pas l’état du bouton. Par défaut, le texte associé s’affiche à droite de la case à cocher. Pour afficher du texte à gauche de la case à cocher, utilisez le ou BS_RIGHTBUTTON le BS_LEFTTEXT style.
BS_COMMANDLINK Crée un bouton de lien de commande. Un bouton de lien de commande est un bouton de commande spécifique à Windows Vista qui affiche une flèche verte à gauche du texte principal et une note sous le texte principal. Vous pouvez définir le texte de la note à l’aide CButton::SetNotede .
BS_DEFCOMMANDLINK Crée un bouton de lien de commande. Un bouton de lien de commande est un bouton de commande spécifique à Windows Vista qui affiche une flèche verte à gauche du texte principal et une note sous le texte principal. Vous pouvez définir le texte de la note à l’aide CButton::SetNotede . Si le bouton se trouve dans une boîte de dialogue, l’appui sur la touche Entrée envoie une BN_CLICKED notification à la boîte de dialogue même si le bouton n’a pas le focus d’entrée.
BS_DEFPUSHBUTTON Crée un bouton de commande qui a une bordure noire lourde. Si le bouton se trouve dans une boîte de dialogue, l’appui sur la touche Entrée envoie une BN_CLICKED notification à la boîte de dialogue même si le bouton n’a pas le focus d’entrée.
BS_DEFSPLITBUTTON Crée un bouton fractionné. Un bouton fractionné est un bouton de commande spécifique à Windows Vista qui contient un bouton adjacent à une flèche déroulante. Lorsque vous cliquez sur le bouton, la commande par défaut est exécutée. Lorsque vous cliquez sur la flèche déroulante, un menu de commandes supplémentaires s’affiche. Si le bouton fractionné se trouve dans une boîte de dialogue, appuyer sur la touche Entrée envoie une BN_CLICKED notification à la boîte de dialogue même si le bouton n’a pas le focus d’entrée
BS_GROUPBOX Crée un rectangle dans lequel d’autres boutons peuvent être regroupés. Le texte associé à ce style s’affiche dans le coin supérieur gauche du rectangle.
BS_OWNERDRAW Crée un bouton dessiné par le propriétaire. L’infrastructure appelle la DrawItem méthode lorsqu’un aspect visuel du bouton a changé. Ce style doit être défini lorsque vous utilisez la CBitmapButton classe.
BS_PUSHBUTTON Crée un bouton de commande qui envoie une BN_CLICKED notification à la fenêtre propriétaire lorsque l’utilisateur clique sur le bouton.
BS_RADIOBUTTON Crée une case d’option avec deux états : BST_CHECKED et BST_UNCHECKED. Les cases d’option sont généralement utilisées dans des groupes, chaque groupe ayant un maximum d’une option activée à la fois. Cliquer sur le bouton envoie une BN_CLICKED notification à la fenêtre propriétaire, mais ne modifie pas automatiquement l’état d’un bouton dans le groupe. Par défaut, le texte associé s’affiche à droite de la case d’option. Pour afficher du texte à gauche de la case d’option, utilisez le ou BS_RIGHTBUTTON le BS_LEFTTEXT style.
BS_SPLITBUTTON Crée un bouton fractionné. Un bouton fractionné est un bouton de commande spécifique à Windows Vista qui contient un bouton adjacent à une flèche déroulante. Lorsque vous cliquez sur le bouton, la commande par défaut est exécutée. Lorsque vous cliquez sur la flèche déroulante, un menu de commandes supplémentaires s’affiche.
BS_USERBUTTON Obsolète, mais fourni pour la compatibilité avec les versions 16 bits de Windows. Les applications Win32 doivent utiliser BS_OWNERDRAW à la place.

Case d’option et styles de case à cocher

Le tableau suivant répertorie les styles spécifiques aux cases d’option et aux cases à cocher. Ces styles sont ignorés dans tous les autres types de boutons. Vous pouvez éventuellement choisir une ou plusieurs des options suivantes.

Style Description
BS_LEFTTEXT En cas de combinaison avec une case d’option ou un style de case à cocher, le texte s’affiche sur le côté gauche de la case d’option ou de la case à cocher.
BS_RIGHTBUTTON En cas de combinaison avec une case d’option ou un style de case à cocher, le texte s’affiche sur le côté gauche de la case d’option ou de la case à cocher. Ce style est identique au BS_LEFTTEXT style.
BS_PUSHLIKE Génère une case à cocher ou une case d’option et se comporte comme un bouton de commande. Le bouton s’affiche lorsque son état est BST_CHECKED, enfoncé et grisé lorsque son état est BST_INDETERMINATE, et relâché lorsque son état est BST_UNCHECKED.

Styles d’alignement du texte du bouton

Le tableau suivant répertorie les options d’alignement de texte horizontal et vertical. Vous pouvez éventuellement choisir l’une des options suivantes.

Style Description
BS_LEFT La gauche aligne le texte dans le rectangle du bouton. Toutefois, si le bouton est une case à cocher ou une case d’option qui n’a pas le BS_RIGHTBUTTON style, le texte est aligné à gauche sur le côté droit de la case à cocher ou sur la case d’option.
BS_RIGHT Aligne à droite le texte dans le rectangle du bouton. Toutefois, si le bouton est une case à cocher ou une case d’option qui n’a pas le BS_RIGHTBUTTON style, le texte est aligné à droite sur le côté droit de la case à cocher ou de la case d’option.
BS_CENTER Centre le texte horizontalement dans le rectangle du bouton.
BS_TOP Place le texte en haut du rectangle du bouton.
BS_BOTTOM Place le texte en bas du rectangle du bouton.
BS_VCENTER Centre le texte verticalement dans le rectangle du bouton.

Options de contenu du bouton

Le tableau suivant répertorie les options qui indiquent ce qui est affiché dans le bouton. Les types de boutons qui affichent uniquement le texte ignorent ces styles. Vous pouvez éventuellement choisir l’une des options suivantes.

Style Description
BS_BITMAP Spécifie que le bouton affiche une bitmap.
BS_ICON Spécifie que le bouton affiche une icône.
BS_TEXT Spécifie que le bouton affiche du texte.

Autres options de bouton

Le tableau suivant répertorie les options supplémentaires que vous pouvez utiliser avec n’importe quel type de bouton. Vous pouvez éventuellement choisir une ou plusieurs des options suivantes.

Style Description
BS_FLAT Spécifie que le bouton est à deux dimensions et n’est pas dessiné avec l’ombrage par défaut pour créer une image à trois dimensions.
BS_MULTILINE Encapsule le texte du bouton sur plusieurs lignes si la chaîne de texte est trop longue pour s’adapter à une seule ligne dans le rectangle du bouton.
BS_NOTIFY Active un bouton pour envoyer , BN_KILLFOCUSet BN_SETFOCUS des BN_DBLCLKmessages de notification à sa fenêtre parente. Notez que les boutons envoient la BN_CLICKED notification, que ce style soit spécifié ou non.

Styles de zone de liste modifiable

Les styles de zone de liste modifiable suivants sont disponibles dans MFC. Pour plus d’informations sur les styles de zone de liste modifiable dans Windows, consultez Styles de zone de liste modifiable (Windows).

Style Description
CBS_AUTOHSCROLL Fait défiler automatiquement le texte dans le contrôle d’édition à droite lorsque l’utilisateur tape un caractère à la fin de la ligne. Si ce style n’est pas défini, seul le texte qui rentre dans la limite rectangulaire est autorisé.
CBS_DISABLENOSCROLL La zone de liste affiche une barre de défilement verticale désactivée lorsque la zone de liste ne contient pas suffisamment d’éléments à faire défiler. Sans ce style, la barre de défilement est masquée lorsque la zone de liste ne contient pas assez d'éléments.
CBS_DROPDOWN Similaire à CBS_SIMPLE, sauf que la zone de liste n’est pas affichée, sauf si l’utilisateur sélectionne une icône en regard du contrôle d’édition.
CBS_DROPDOWNLIST Similaire à CBS_DROPDOWN, sauf que le contrôle d’édition est remplacé par un élément de texte statique qui affiche la sélection actuelle dans la zone de liste.
CBS_HASSTRINGS Une zone de liste modifiable de dessin propriétaire contient des éléments constitués de chaînes. La zone de liste modifiable contient la mémoire et les pointeurs des chaînes, ce qui permet à l’application d’utiliser la fonction membre GetText pour récupérer le texte d’un élément particulier.
CBS_LOWERCASE Convertit en minuscules tout le texte dans le champ de sélection et la liste.
CBS_NOINTEGRALHEIGHT Spécifie que la taille de la zone de liste modifiable est exactement la taille spécifiée par l’application lorsqu’elle a créé la zone de liste modifiable. Généralement, Windows redimensionne une zone de liste modifiable pour qu’elle n’affiche aucun élément de manière partielle.
CBS_OEMCONVERT Le texte entré dans le contrôle d’édition de zone de liste modifiable est converti du jeu de caractères ANSI au jeu de caractères OEM, puis revient à ANSI. Cela garantit la conversion appropriée des caractères quand l’application appelle la fonction Windows AnsiToOem pour convertir une chaîne ANSI dans la zone de liste modifiable en caractères OEM. Ce style est le plus utile pour les zones de liste modifiable qui contiennent des noms de fichiers et s’applique uniquement aux zones de liste modifiable créées avec le ou CBS_DROPDOWN les CBS_SIMPLE styles.
CBS_OWNERDRAWFIXED Le propriétaire de la zone de liste est responsable du dessin de son contenu ; les éléments de la zone de liste sont tous de la même hauteur.
CBS_OWNERDRAWVARIABLE Le propriétaire de la zone de liste est responsable du dessin de son contenu ; les éléments de la zone de liste sont variables en hauteur.
CBS_SIMPLE La zone de liste s’affiche à tout moment. La sélection actuelle dans la zone de liste s’affiche dans le contrôle d’édition.
CBS_SORT Trie automatiquement les chaînes entrées dans la zone de liste.
CBS_UPPERCASE Convertit en majuscules tout le texte dans le champ de sélection et dans la liste.

Modifier les styles

Les styles d’édition s’appliquent aux CEdit objets Class . Spécifiez une combinaison de styles dans le dwStyle paramètre de CEdit::Create. Pour plus d’informations sur la modification des styles de contrôle dans Windows, consultez Modifier les styles de contrôle (Windows).

Style Description
ES_AUTOHSCROLL Fait défiler automatiquement le texte vers la droite de 10 caractères lorsque l’utilisateur tape un caractère à la fin de la ligne. Lorsque l’utilisateur appuie sur la touche Entrée, le contrôle fait défiler tout le texte jusqu’à la position 0.
ES_AUTOVSCROLL Fait défiler automatiquement le texte vers le haut d’une page lorsque l’utilisateur appuie sur Entrée sur la dernière ligne.
ES_CENTER Centre le texte dans un contrôle d’édition à une seule ligne ou multiligne.
ES_LEFT Aligne à gauche le texte dans un contrôle d’édition à une seule ligne ou multiligne.
ES_LOWERCASE Convertit tous les caractères en minuscules, car ils sont tapés dans le contrôle d’édition.
ES_MULTILINE Désigne un contrôle d’édition à plusieurs lignes. (La valeur par défaut est une seule ligne.) Si le ES_AUTOVSCROLL style est spécifié, le contrôle d’édition affiche autant de lignes que possible et fait défiler verticalement lorsque l’utilisateur appuie sur la touche Entrée. Si ES_AUTOVSCROLL ce n’est pas le cas, le contrôle d’édition affiche autant de lignes que possible et les bips si entrée est enfoncée lorsqu’aucune ligne supplémentaire ne peut être affichée. Si le ES_AUTOHSCROLL style est spécifié, le contrôle d’édition à plusieurs lignes défile automatiquement horizontalement lorsque le trait passe au-delà du bord droit du contrôle. Pour démarrer une nouvelle ligne, l’utilisateur doit appuyer sur Entrée. Si ES_AUTOHSCROLL ce n’est pas le cas, le contrôle encapsule automatiquement les mots au début de la ligne suivante si nécessaire ; une nouvelle ligne est également démarrée si entrée est enfoncée. La position du wordwrap est déterminée par la taille de la fenêtre. Si la taille de la fenêtre change, la position wordwrap change et le texte est réécrit. Les contrôles d’édition à plusieurs lignes peuvent avoir des barres de défilement. Un contrôle d’édition avec des barres de défilement traite ses propres messages de barre de défilement. Modifiez les contrôles sans barres de défilement, comme décrit ci-dessus et traitez les messages de défilement envoyés par la fenêtre parente.
ES_NOHIDESEL Normalement, un contrôle d’édition masque la sélection lorsque le contrôle perd le focus d’entrée et inverse la sélection lorsque le contrôle reçoit le focus d’entrée. La spécification supprime ES_NOHIDESEL cette action par défaut.
ES_NUMBER Autorise uniquement les chiffres à entrer dans le contrôle d’édition.
ES_OEMCONVERT Le texte entré dans le contrôle d’édition est converti du jeu de caractères ANSI au jeu de caractères OEM, puis revenez à ANSI. Cela garantit une conversion de caractères appropriée lorsque l’application appelle la AnsiToOem fonction Windows pour convertir une chaîne ANSI dans le contrôle d’édition en caractères OEM. Ce style est plus utile pour les contrôles de modification qui contiennent des noms de fichiers.
ES_PASSWORD Affiche tous les caractères sous la forme d’un astérisque (*) tel qu’ils sont tapés dans le contrôle d’édition. Une application peut utiliser la SetPasswordChar fonction membre pour modifier le caractère affiché.
ES_READONLY Empêche l’utilisateur d’entrer ou de modifier du texte dans le contrôle d’édition.
ES_RIGHT Aligne avec le bouton droit le texte dans un contrôle d’édition à une seule ligne ou multiligne.
ES_UPPERCASE Convertit tous les caractères en majuscules, car ils sont tapés dans le contrôle d’édition.
ES_WANTRETURN Spécifie qu’un retour chariot doit être inséré lorsque l’utilisateur appuie sur la touche ENTRÉE tout en entrant du texte dans un contrôle d’édition à plusieurs lignes dans une boîte de dialogue. Sans ce style, appuyer sur la touche Entrée a le même effet que sur le bouton push par défaut de la boîte de dialogue. Ce style n’a aucun effet sur un contrôle d’édition à ligne unique.

Styles de fenêtre frame

Les styles de fenêtre frame s’appliquent aux CFrameWnd objets Class . Spécifiez une combinaison de styles dans le dwStyle paramètre de CFrameWnd::Create.

Style Description
FWS_ADDTOTITLE Spécifie des informations à ajouter à la fin d’un titre de fenêtre frame. Par exemple, « Microsoft Draw - Drawing in Document1 ». Vous pouvez spécifier les chaînes affichées sous l’onglet Chaînes de modèle de document de l’Assistant Application. Si vous devez désactiver cette option, remplacez la CWnd::PreCreateWindow fonction membre.
FWS_PREFIXTITLE Affiche le nom du document avant le nom de l’application dans un titre de fenêtre frame. Par exemple, « Document - WordPad ». Vous pouvez spécifier les chaînes affichées sous l’onglet Chaînes de modèle de document de l’Assistant Application. Si vous devez désactiver cette option, remplacez la CWnd::PreCreateWindow fonction membre.
FWS_SNAPTOBARS Contrôle le dimensionnement de la fenêtre frame qui entoure une barre de contrôle lorsqu’elle se trouve dans une fenêtre flottante plutôt que ancrée dans une fenêtre frame. Ce style dimensionne la fenêtre pour qu’elle corresponde à la barre de contrôle.

Styles de zone de liste

Les styles de zone de liste s’appliquent aux CListBox objets Class . Spécifiez une combinaison de styles dans le dwStyle paramètre de CListBox::Create. Pour plus d’informations sur les styles de zone de liste dans Windows, consultez Styles de zone de liste (Windows).

Style Description
LBS_DISABLENOSCROLL La zone de liste affiche une barre de défilement verticale désactivée lorsque la zone de liste ne contient pas suffisamment d’éléments à faire défiler. Sans ce style, la barre de défilement est masquée lorsque la zone de liste ne contient pas assez d'éléments.
LBS_EXTENDEDSEL L’utilisateur peut sélectionner plusieurs éléments à l’aide de la touche Maj et de la souris ou des combinaisons de touches spéciales.
LBS_HASSTRINGS Spécifie une zone de liste de dessin propriétaire qui contient des éléments constitués de chaînes. La zone de liste contient la mémoire et les pointeurs des chaînes afin que l'application puisse utiliser la fonction membre GetText pour récupérer le texte d'un élément particulier.
LBS_MULTICOLUMN Spécifie une zone de liste multicolonne qui fait défiler horizontalement. La fonction membre SetColumnWidth définit la largeur des colonnes.
LBS_MULTIPLESEL La sélection de chaîne est activée chaque fois que l’utilisateur clique ou double-clique sur la chaîne. Plusieurs chaînes peuvent être sélectionnées.
LBS_NODATA Spécifie une zone de liste sans données. Spécifiez ce style lorsque le nombre d'éléments dans la zone de liste dépasse 1000. Une zone de liste sans données doit également avoir le LBS_OWNERDRAWFIXED style, mais ne doit pas avoir le ou LBS_HASSTRINGS le LBS_SORT style.

Une zone de liste sans données s'apparente à une zone de liste personnalisée par son propriétaire sauf qu'elle ne contient aucune chaîne ou donnée bitmap d'un élément. Les commandes d'ajout, d'insertion ou de suppression d'un élément ignorent toutes les données d'un élément donné ; les requêtes de recherche d'une chaîne dans la zone de liste échouent toujours. Le système envoie le WM_DRAWITEM message à la fenêtre propriétaire lorsqu’un élément doit être dessiné. Le membre itemID de la DRAWITEMSTRUCT structure passée avec le WM_DRAWITEM message spécifie le numéro de ligne de l’élément à dessiner. Une zone de liste sans données n’envoie pas de WM_DELETEITEM message.
LBS_NOINTEGRALHEIGHT La taille de la zone de liste est exactement la taille spécifiée par l’application lors de la création de la zone de liste. Généralement, Windows redimensionne une zone de liste pour qu'elle n'affiche aucun élément de manière partielle.
LBS_NOREDRAW L’affichage de la zone de liste n’est pas mis à jour lorsque des modifications sont apportées. Ce style peut être modifié à tout moment en envoyant un WM_SETREDRAW message.
LBS_NOSEL Spécifie que la zone de liste contient des éléments qui peuvent être visualisés mais pas sélectionnés.
LBS_NOTIFY La fenêtre parente reçoit un message d’entrée chaque fois que l’utilisateur clique ou double-clique sur une chaîne.
LBS_OWNERDRAWFIXED Le propriétaire de la zone de liste est responsable du dessin de son contenu ; les éléments de la zone de liste sont de la même hauteur.
LBS_OWNERDRAWVARIABLE Le propriétaire de la zone de liste est responsable du dessin de son contenu ; les éléments de la zone de liste sont variables en hauteur.
LBS_SORT Les chaînes de la zone de liste sont triées par ordre alphabétique.
LBS_STANDARD Les chaînes de la zone de liste sont triées par ordre alphabétique et la fenêtre parente reçoit un message d’entrée chaque fois que l’utilisateur clique ou double-clique sur une chaîne. La zone de liste contient des bordures de chaque côté.
LBS_USETABSTOPS Permet à une zone de liste de reconnaître et de développer des tabulations lors du dessin de ses chaînes. Les positions des onglets par défaut correspondent à 32 unités de boîte de dialogue. (Une unité de dialogue est une distance horizontale ou verticale. Une unité de dialogue horizontale est égale à un quart de l’unité de largeur de base de dialogue actuelle. Les unités de base de boîte de dialogue sont calculées en fonction de la hauteur et de la largeur de la police système actuelle. La GetDialogBaseUnits fonction Windows retourne les unités de base de boîte de dialogue actuelles en pixels.) Ce style ne doit pas être utilisé avec LBS_OWNERDRAWFIXED.
LBS_WANTKEYBOARDINPUT Le propriétaire de la zone de liste reçoit ou WM_CHARTOITEM reçoit des WM_VKEYTOITEM messages chaque fois que l’utilisateur appuie sur une touche pendant que la zone de liste a le focus d’entrée. Cela permet à une application d'effectuer un traitement spécial sur l'entrée de clavier.

Styles de boîte de message

Les styles de boîte de message s’appliquent aux AfxMessageBox éléments. Spécifiez une combinaison de styles dans le nType paramètre de AfxMessageBox. Pour plus d’informations sur les styles de boîte de message dans Windows, consultez MessageBox Fonction (Windows).

Les styles de boîte de message suivants sont disponibles.

Types de boîtes de message

Style Description
MB_ABORTRETRYIGNORE La zone de message contient trois boutons push : Abandon, Nouvelle tentative et Ignorer.
MB_OK La boîte de message contient un bouton push : OK.
MB_OKCANCEL La boîte de message contient deux boutons push : OK et Cancel.
MB_RETRYCANCEL La boîte de message contient deux boutons push : réessayer et annuler.
MB_YESNO La boîte de message contient deux boutons push : Oui et Non.
MB_YESNOCANCEL La boîte de message contient trois boutons push : Oui, Non et Annuler.

Modalité de la boîte de message

Style Description
MB_APPLMODAL L’utilisateur doit répondre à la boîte de message avant de poursuivre le travail dans la fenêtre active. Toutefois, l’utilisateur peut passer aux fenêtres d’autres applications et travailler dans ces fenêtres. La valeur par défaut est MB_APPLMODAL si ni ni n’est MB_SYSTEMMODAL MB_TASKMODAL spécifié.
MB_SYSTEMMODAL Toutes les applications sont suspendues jusqu’à ce que l’utilisateur réponde à la boîte de message. Les boîtes de message modales système sont utilisées pour informer l’utilisateur des erreurs graves et potentiellement nuisibles qui nécessitent une attention immédiate et doivent être utilisées avec parcimonie.
MB_TASKMODAL Similaire à MB_APPLMODAL, mais pas utile dans une application de classe Microsoft Foundation. Cet indicateur est réservé à une application ou une bibliothèque appelante qui n’a pas de handle de fenêtre disponible.

Icônes de boîte de message

Style Description
MB_ICONEXCLAMATION Une icône de point d’exclamation s’affiche dans la boîte de message.
MB_ICONINFORMATION Une icône composée d’un « I » dans un cercle apparaît dans la boîte de message.
MB_ICONQUESTION Une icône de point d’interrogation s’affiche dans la boîte de message.
MB_ICONSTOP Une icône de signature d’arrêt s’affiche dans la boîte de message.

Boutons par défaut de la zone de message

Style Description
MB_DEFBUTTON1 Le premier bouton est la valeur par défaut. Notez que le premier bouton est toujours la valeur par défaut, sauf si MB_DEFBUTTON2 elle MB_DEFBUTTON3 est spécifiée.
MB_DEFBUTTON2 Le deuxième bouton est la valeur par défaut.
MB_DEFBUTTON3 Le troisième bouton est la valeur par défaut.

Styles de barre de défilement

Les styles de barre de défilement s’appliquent aux CScrollBar objets Class . Spécifiez une combinaison de styles dans le dwStyle paramètre de CScrollBar::Create. Pour plus d’informations sur les styles de contrôle de barre de défilement dans Windows, consultez Styles de contrôle de barre de défilement (Windows)

Style Description
SBS_BOTTOMALIGN Utilisé avec le SBS_HORZ style. Le bord inférieur de la barre de défilement est aligné sur le bord inférieur du rectangle spécifié dans la Create fonction membre. La barre de défilement a la hauteur par défaut pour les barres de défilement système.
SBS_HORZ Désigne une barre de défilement horizontale. Si ni le SBS_BOTTOMALIGN style n’est SBS_TOPALIGN spécifié, la barre de défilement a la hauteur, la largeur et la position indiquées dans la Create fonction membre.
SBS_LEFTALIGN Utilisé avec le SBS_VERT style. Le bord gauche de la barre de défilement est aligné sur le bord gauche du rectangle spécifié dans la Create fonction membre. La barre de défilement a la largeur par défaut pour les barres de défilement système.
SBS_RIGHTALIGN Utilisé avec le SBS_VERT style. Le bord droit de la barre de défilement est aligné sur le bord droit du rectangle spécifié dans la Create fonction membre. La barre de défilement a la largeur par défaut pour les barres de défilement système.
SBS_SIZEBOX Désigne une zone de taille. Si aucun style SBS_SIZEBOXBOTTOMRIGHTALIGN n’est SBS_SIZEBOXTOPLEFTALIGN spécifié, la zone de taille a la hauteur, la largeur et la position indiquées dans la Create fonction membre.
SBS_SIZEBOXBOTTOMRIGHTALIGN Utilisé avec le SBS_SIZEBOX style. Le coin inférieur droit de la zone de taille est aligné sur le coin inférieur droit du rectangle spécifié dans la Create fonction membre. La zone de taille a la taille par défaut pour les zones de taille système.
SBS_SIZEBOXTOPLEFTALIGN Utilisé avec le SBS_SIZEBOX style. Le coin supérieur gauche de la zone de taille est aligné sur le coin supérieur gauche du rectangle spécifié dans la Create fonction membre. La zone de taille a la taille par défaut pour les zones de taille système.
SBS_SIZEGRIP Identique à SBS_SIZEBOX, mais avec un bord élevé.
SBS_TOPALIGN Utilisé avec le SBS_HORZ style. Le bord supérieur de la barre de défilement est aligné sur le bord supérieur du rectangle spécifié dans la Create fonction membre. La barre de défilement a la hauteur par défaut pour les barres de défilement système.
SBS_VERT Désigne une barre de défilement verticale. Si ni le SBS_RIGHTALIGN style n’est SBS_LEFTALIGN spécifié, la barre de défilement a la hauteur, la largeur et la position indiquées dans la Create fonction membre.

Styles statiques

Les styles statiques s’appliquent aux CStatic objets Class . Spécifiez une combinaison de styles dans le dwStyle paramètre de CStatic::Create. Pour plus d’informations sur les styles de contrôle statique dans Windows, consultez Styles de contrôle statiques (Windows) .

Style Description
SS_BITMAP Spécifie qu’une bitmap doit être affichée dans le contrôle statique. Le texte donné est le nom d’une bitmap (et non d’un nom de fichier) définie ailleurs dans le fichier de ressources. Le style ignore les paramètres nWidth et nHeight ; le contrôle se dimensionne automatiquement pour prendre en charge la bitmap.
SS_BLACKFRAME Spécifie une zone avec un cadre dessiné avec la même couleur que les cadres de fenêtre. La valeur par défaut est noir.
SS_BLACKRECT Spécifie un rectangle rempli de la couleur utilisée pour dessiner des cadres de fenêtre. La valeur par défaut est noir.
SS_CENTER Désigne un rectangle simple et affiche le texte donné centré dans le rectangle. Le texte est mis en forme avant son affichage. Les mots qui s’étendraient au-delà de la fin d’une ligne sont automatiquement encapsulés au début de la ligne centrée suivante.
SS_CENTERIMAGE Spécifie que, si la bitmap ou l’icône est inférieure à la zone cliente du contrôle statique, le reste de la zone cliente est rempli avec la couleur du pixel dans le coin supérieur gauche de la bitmap ou de l’icône. Si le contrôle statique contient une seule ligne de texte, le texte est centré verticalement dans la zone cliente du contrôle.
SS_ENDELLIPSIS ou SS_PATHELLIPSIS remplace une partie de la chaîne donnée par des points de suspension, si nécessaire, afin que le résultat s’intègre dans le rectangle spécifié.

Vous pouvez spécifier SS_END_ELLIPSIS de remplacer des caractères à la fin de la chaîne ou SS_PATHELLIPSIS de remplacer des caractères au milieu de la chaîne. Si la chaîne contient des caractères inverses (\), SS_PATHELLIPSIS conserve autant de texte que possible après la dernière barre oblique inverse.
SS_ENHMETAFILE Spécifie qu’un métafichier amélioré doit être affiché dans le contrôle statique. Le texte donné est le nom d’un métafichier. Un contrôle statique de métafichier amélioré a une taille fixe ; le métafichier est mis à l’échelle pour s’adapter à la zone cliente du contrôle statique.
SS_ETCHEDFRAME Dessine le cadre du contrôle statique à l’aide du EDGE_ETCHED style de bord.
SS_ETCHEDHORZ Dessine les bords supérieurs et inférieurs du contrôle statique à l’aide du EDGE_ETCHED style de bord.
SS_ETCHEDVERT Dessine les bords gauche et droit du contrôle statique à l’aide du EDGE_ETCHED style de bord.
SS_GRAYFRAME Spécifie une zone avec un cadre dessiné avec la même couleur que l’arrière-plan de l’écran (bureau). La valeur par défaut est gris.
SS_GRAYRECT Spécifie un rectangle rempli de la couleur utilisée pour remplir l’arrière-plan de l’écran. La valeur par défaut est gris.
SS_ICON Désigne une icône affichée dans la boîte de dialogue. Le texte donné est le nom d’une icône (et non d’un nom de fichier) définie ailleurs dans le fichier de ressources. Les nWidth paramètres et nHeight les paramètres sont ignorés ; l’icône se dimensionne automatiquement.
SS_LEFT Désigne un rectangle simple et affiche le texte donné à gauche dans le rectangle. Le texte est mis en forme avant son affichage. Les mots qui s’étendraient au-delà de la fin d’une ligne sont automatiquement encapsulés au début de la ligne de vidage suivante à gauche.
SS_LEFTNOWORDWRAP Désigne un rectangle simple et affiche le texte donné à gauche dans le rectangle. Les onglets sont développés, mais les mots ne sont pas encapsulés. Le texte qui s’étend au-delà de la fin d’une ligne est clippé.
SS_NOPREFIX Sauf si ce style est spécifié, Windows interprète tous les caractères d’ampersand (&) dans le texte du contrôle pour qu’il s’agisse de caractères de préfixe d’accélérateur. Dans ce cas, l’ampersand est supprimé et le caractère suivant de la chaîne est souligné. Si un contrôle statique doit contenir du texte dans lequel cette fonctionnalité n’est pas souhaitée, SS_NOPREFIX peut être ajouté. Ce style de contrôle statique peut être inclus avec l’un des contrôles statiques définis. Vous pouvez combiner SS_NOPREFIX avec d’autres styles à l’aide de l’opérateur OR au niveau du bit. Cela est le plus souvent utilisé lorsque des noms de fichiers ou d’autres chaînes qui peuvent contenir un ampersand doivent être affichés dans un contrôle statique dans une boîte de dialogue.
SS_NOTIFY Envoie la fenêtre STN_CLICKEDparente, et STN_DBLCLKSTN_DISABLESTN_ENABLE les messages de notification lorsque l’utilisateur clique ou double-clique sur le contrôle.
SS_OWNERDRAW Spécifie que le propriétaire du contrôle statique est responsable du dessin du contrôle. La fenêtre propriétaire reçoit un WM_DRAWITEM message chaque fois que le contrôle doit être dessiné.
SS_REALSIZEIMAGE Empêche le redimensionnement d’une icône statique ou d’un contrôle bitmap (c’est-à-dire des contrôles statiques qui ont le ou SS_BITMAP le SS_ICON style) à mesure qu’il est chargé ou dessiné. Si l’icône ou la bitmap est supérieure à la zone de destination, l’image est clippée.
SS_RIGHT Désigne un rectangle simple et affiche le texte donné à droite dans le rectangle. Le texte est mis en forme avant son affichage. Les mots qui s’étendraient au-delà de la fin d’une ligne sont automatiquement encapsulés au début de la ligne de vidage suivante.
SS_RIGHTJUST Spécifie que le coin inférieur droit d’un contrôle statique avec le style ou SS_ICON SS_BITMAP doit rester fixe lorsque le contrôle est redimensionné. Seuls les côtés supérieur et gauche sont ajustés pour prendre en charge une nouvelle image bitmap ou une nouvelle icône.
SS_SIMPLE Désigne un rectangle simple et affiche une seule ligne de texte vide à gauche dans le rectangle. La ligne de texte ne peut pas être raccourcie ou modifiée de quelque manière que ce soit. (La fenêtre parente ou la boîte de dialogue du contrôle ne doit pas traiter le WM_CTLCOLOR message.)
SS_SUNKEN Dessine une bordure semi-enfoncée autour d’un contrôle statique.
SS_USERITEM Spécifie un élément défini par l’utilisateur.
SS_WHITEFRAME Spécifie une zone avec un cadre dessiné avec la même couleur que l’arrière-plan de la fenêtre. La valeur par défaut est blanc.
SS_WHITERECT Spécifie un rectangle rempli de la couleur utilisée pour remplir l’arrière-plan de la fenêtre. La valeur par défaut est blanc.
SS_WORDELLIPSIS Tronque le texte qui ne correspond pas et ajoute des points de suspension.

Styles de fenêtre

Les styles de fenêtre s’appliquent aux CWnd objets Class . Spécifiez une combinaison de styles dans le paramètre dwStyle de CWnd::Create ou CWnd::CreateEx. Pour plus d’informations sur les styles de fenêtre dans Windows, consultez Styles de fenêtre (Windows) .

Style Description
WS_BORDER Crée une fenêtre qui a une bordure.
WS_CAPTION Crée une fenêtre qui a une barre de titre (implique le WS_BORDER style). Impossible d’utiliser le WS_DLGFRAME style.
WS_CHILD Crée une fenêtre enfant. Impossible d’utiliser le WS_POPUP style.
WS_CHILDWINDOW Identique au WS_CHILD style.
WS_CLIPCHILDREN Exclut la zone occupée par les fenêtres enfants lorsque vous dessinez dans la fenêtre parente. Utilisé lorsque vous créez la fenêtre parente.
WS_CLIPSIBLINGS Clipse les fenêtres enfants par rapport à l’autre ; autrement dit, lorsqu’une fenêtre enfant particulière reçoit un message de peinture, le WS_CLIPSIBLINGS style extrait toutes les autres fenêtres enfants superposées hors de la région de la fenêtre enfant à mettre à jour. (S’il WS_CLIPSIBLINGS n’est pas donné et que les fenêtres enfants se chevauchent, lorsque vous dessinez dans la zone cliente d’une fenêtre enfant, il est possible de dessiner dans la zone cliente d’une fenêtre enfant voisine.) Pour une utilisation avec le WS_CHILD style uniquement.
WS_DISABLED Crée une fenêtre initialement désactivée.
WS_DLGFRAME Crée une fenêtre avec une double bordure, mais aucun titre.
WS_GROUP Spécifie le premier contrôle d’un groupe de contrôles dans lequel l’utilisateur peut passer d’un contrôle à l’autre avec les touches de direction. Tous les contrôles définis avec le WS_GROUP style FALSE après le premier contrôle appartiennent au même groupe. Le contrôle suivant avec le WS_GROUP style démarre le groupe suivant (c’est-à-dire qu’un groupe se termine au début suivant).
WS_HSCROLL Crée une fenêtre qui a une barre de défilement horizontale.
WS_ICONIC Crée une fenêtre initialement réduite. Identique au WS_MINIMIZE style.
WS_MAXIMIZE Crée une fenêtre de taille maximale.
WS_MAXIMIZEBOX Crée une fenêtre qui a un bouton Agrandir.
WS_MINIMIZE Crée une fenêtre initialement réduite. Pour une utilisation avec le WS_OVERLAPPED style uniquement.
WS_MINIMIZEBOX Crée une fenêtre qui a un bouton Réduire.
WS_OVERLAPPED Crée une fenêtre superposée. Une fenêtre superposée a généralement une légende et une bordure.
WS_OVERLAPPEDWINDOW Crée une fenêtre qui se chevauche avec les styles et les WS_OVERLAPPEDstyles .WS_MAXIMIZEBOX WS_CAPTIONWS_SYSMENUWS_THICKFRAMEWS_MINIMIZEBOX
WS_POPUP Crée une fenêtre contextuelle. Impossible d’utiliser le WS_CHILD style.
WS_POPUPWINDOW Crée une fenêtre contextuelle avec les styles et WS_SYSMENU les WS_POPUPWS_BORDERstyles. Le WS_CAPTION style doit être combiné avec le WS_POPUPWINDOW style pour rendre le menu Contrôle visible.
WS_SIZEBOX Crée une fenêtre qui a une bordure de dimensionnement. Identique au WS_THICKFRAME style.
WS_SYSMENU Crée une fenêtre qui a une zone de menu Contrôle dans sa barre de titre. Utilisé uniquement pour les fenêtres avec des barres de titre.
WS_TABSTOP Spécifie l’un des contrôles par lesquels l’utilisateur peut se déplacer à l’aide de la touche TAB. La touche TAB déplace l’utilisateur vers le contrôle suivant spécifié par le WS_TABSTOP style.
WS_THICKFRAME Crée une fenêtre avec un cadre épais qui peut être utilisé pour dimensionner la fenêtre.
WS_TILED Crée une fenêtre superposée. Une fenêtre superposée a une barre de titre et une bordure. Identique au WS_OVERLAPPED style.
WS_TILEDWINDOW Crée une fenêtre qui se chevauche avec les styles et les WS_OVERLAPPEDstyles .WS_MAXIMIZEBOX WS_CAPTIONWS_SYSMENUWS_THICKFRAMEWS_MINIMIZEBOX Identique au WS_OVERLAPPEDWINDOW style.
WS_VISIBLE Crée une fenêtre initialement visible.
WS_VSCROLL Crée une fenêtre qui a une barre de défilement verticale.

Styles de fenêtre étendus

Les styles de fenêtre étendus s’appliquent aux CWnd objets Class . Spécifiez une combinaison de styles dans le dwExStyle paramètre de CWnd::CreateEx. Pour plus d’informations sur les styles de fenêtre étendus dans Windows, consultez Styles de fenêtre étendus (Windows)

Style Description
WS_EX_ACCEPTFILES Spécifie qu’une fenêtre créée avec ce style accepte les fichiers glisser-déplacer.
WS_EX_APPWINDOW Force une fenêtre de niveau supérieur à la barre des tâches lorsque la fenêtre est visible.
WS_EX_CLIENTEDGE Spécifie qu’une fenêtre a une apparence 3D , c’est-à-dire une bordure avec un bord enfoncé.
WS_EX_CONTEXTHELP Inclut un point d’interrogation dans la barre de titre de la fenêtre. Lorsque l’utilisateur clique sur le point d’interrogation, le curseur passe à un point d’interrogation avec un pointeur. Si l’utilisateur clique ensuite sur une fenêtre enfant, l’enfant reçoit un WM_HELP message.
WS_EX_CONTROLPARENT Permet à l’utilisateur de naviguer entre les fenêtres enfants de la fenêtre à l’aide de la touche TAB.
WS_EX_DLGMODALFRAME Désigne une fenêtre avec une double bordure qui peut (éventuellement) être créée avec une barre de titre lorsque vous spécifiez l’indicateur WS_CAPTION de style dans le dwStyle paramètre.
WS_EX_LAYERED La fenêtre est une fenêtre superposée. Ce style ne peut pas être utilisé si la fenêtre a un style de classe de l’une ou l’autre CS_OWNDC CS_CLASSDC. Toutefois, Microsoft Windows 8 prend en charge le WS_EX_LAYERED style des fenêtres enfants, où les versions précédentes de Windows la prennent en charge uniquement pour les fenêtres de niveau supérieur.
WS_EX_LEFT Donne aux propriétés génériques génériques alignées à gauche de la fenêtre. Il s’agit de la valeur par défaut.
WS_EX_LEFTSCROLLBAR Place une barre de défilement verticale à gauche de la zone cliente.
WS_EX_LTRREADING Affiche le texte de la fenêtre à l’aide des propriétés de l’ordre de lecture de gauche à droite. Il s’agit de la valeur par défaut.
WS_EX_MDICHILD Crée une fenêtre enfant MDI.
WS_EX_NOPARENTNOTIFY Spécifie qu’une fenêtre enfant créée avec ce style n’envoie pas le WM_PARENTNOTIFY message à sa fenêtre parente lorsque la fenêtre enfant est créée ou détruite.
WS_EX_OVERLAPPEDWINDOW Combine les styles et WS_EX_WINDOWEDGE les WS_EX_CLIENTEDGE styles
WS_EX_PALETTEWINDOW Combine les styles et WS_EX_TOPMOST les WS_EX_WINDOWEDGE styles.
WS_EX_RIGHT Fournit des propriétés génériques alignées à droite dans une fenêtre. Cela dépend de la classe de la fenêtre.
WS_EX_RIGHTSCROLLBAR Place une barre de défilement verticale (le cas échéant) à droite de la zone cliente. Il s’agit de la valeur par défaut.
WS_EX_RTLREADING Affiche le texte de la fenêtre à l’aide des propriétés de l’ordre de lecture de droite à gauche.
WS_EX_STATICEDGE Crée une fenêtre avec un style de bordure tridimensionnel destiné à être utilisé pour les éléments qui n’acceptent pas l’entrée utilisateur.
WS_EX_TOOLWINDOW Crée une fenêtre outil, qui est une fenêtre destinée à être utilisée comme barre d’outils flottante. Une fenêtre Outil a une barre de titre plus courte qu'une barre de titre normale, et le titre de la fenêtre est dessiné dans une police de plus petite taille. Une fenêtre Outil ne s’affiche ni dans la barre des tâches ni dans la fenêtre qui apparaît lorsque l’utilisateur appuie sur ALT+TAB.
WS_EX_TOPMOST Spécifie qu’une fenêtre créée avec ce style doit être placée au-dessus de toutes les fenêtres non supérieures et rester au-dessus de celles-ci même lorsque la fenêtre est désactivée. Une application peut utiliser la fonction membre SetWindowPos pour ajouter ou supprimer cet attribut.
WS_EX_TRANSPARENT Spécifie qu’une fenêtre créée avec ce style doit être transparente. Autrement dit, les fenêtres qui se trouvent sous la fenêtre ne sont pas masquées par la fenêtre. Une fenêtre créée avec ce style reçoit des messages uniquement après la mise à jour de toutes les fenêtres WM_PAINT frères sous celle-ci.
WS_EX_WINDOWEDGE Spécifie qu’une fenêtre a une bordure avec un bord élevé.

Voir aussi

Vue d’ensemble de la classe MFC
CWnd::Create
CWnd::CreateEx
CEdit::Create
CScrollBar::Create
CStatic::Create
AfxMessageBox
CreateWindow
CreateWindowEx
Styles de bouton (Windows)
Styles de zone de liste modifiable (Windows)
Modifier les styles de contrôle (Windows)
Styles de zone de liste (Windows)
MessageBox Fonction (Windows)
Styles de contrôle de barre de défilement (Windows)
Styles de contrôle statiques (Windows)
Styles de fenêtre (Windows)
Styles de fenêtre étendus (Windows)