Styles de contrôle statiques

Pour créer un contrôle statique à l’aide de la fonction CreateWindow ou CreateWindowEx , spécifiez la classe STATIC, les constantes de style de fenêtre appropriées et une combinaison des styles de contrôle statiques suivants.

Constant Description
SS_BITMAP
Une bitmap doit être affichée dans le contrôle statique. Le texte 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
Zone avec un cadre dessiné de la même couleur que les cadres de fenêtre. Cette couleur est noire dans le jeu de couleurs par défaut.
SS_BLACKRECT
Rectangle rempli de la couleur de cadre de fenêtre actuelle. Cette couleur est noire dans le jeu de couleurs par défaut.
SS_CENTER
Rectangle simple et centre le texte dans le rectangle. Le texte est mis en forme avant son affichage. Les mots qui s’étendent au-delà de la fin d’une ligne sont automatiquement encapsulés au début de la ligne centrée suivante. Les mots qui sont plus longs que la largeur du contrôle sont tronqués.
SS_CENTERIMAGE
Une bitmap est centrée dans le contrôle statique qui le contient. Le contrôle n’est pas redimensionné, de sorte qu’une image bitmap trop grande pour le contrôle soit découpée. Si le contrôle statique contient une seule ligne de texte, le texte est centré verticalement dans la zone cliente du contrôle.
SS_EDITCONTROL
Le contrôle statique duplique les caractéristiques d’affichage de texte d’un contrôle d’édition multiligne. Plus précisément, la largeur moyenne des caractères est calculée de la même manière qu’avec un contrôle d’édition, et la fonction n’affiche pas une dernière ligne partiellement visible.
SS_ENDELLIPSIS
Si la fin d’une chaîne ne tient pas dans le rectangle, elle est tronquée et les points de suspension sont ajoutés. Si un mot qui n’est pas à la fin de la chaîne dépasse les limites du rectangle, il est tronqué sans points de suspension. L’utilisation de ce style forcera le texte du contrôle à se trouver sur une ligne sans retour à la ligne. Comparez avec SS_PATHELLIPSIS et SS_WORDELLIPSIS.
SS_ENHMETAFILE
Un métafichier amélioré doit être affiché dans le contrôle statique. Le texte 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 style de bord EDGE_ETCHED . Pour plus d’informations, consultez la fonction DrawEdge .
SS_ETCHEDHORZ
Dessine les bords supérieurs et inférieurs du contrôle statique à l’aide du style de bord EDGE_ETCHED . Pour plus d’informations, consultez la fonction DrawEdge .
SS_ETCHEDVERT
Dessine les bords gauche et droit du contrôle statique à l’aide du style de bord EDGE_ETCHED . Pour plus d’informations, consultez la fonction DrawEdge .
SS_GRAYFRAME
Zone avec un cadre dessiné avec la même couleur que l’arrière-plan de l’écran (bureau). Cette couleur est grise dans le jeu de couleurs par défaut.
SS_GRAYRECT
Rectangle rempli avec la couleur d’arrière-plan de l’écran actuelle. Cette couleur est grise dans le jeu de couleurs par défaut.
SS_ICON
Icône à afficher dans la boîte de dialogue. Si le contrôle est créé dans le cadre d’une boîte de dialogue, le texte est le nom d’une icône (et non d’un nom de fichier) définie ailleurs dans le fichier de ressources. Si le contrôle est créé via CreateWindow ou une fonction associée, le texte est le nom d’une icône (et non un nom de fichier) définie dans le fichier de ressources associé au module spécifié par le paramètre hInstance à CreateWindow.
L’icône peut être un curseur animé.
Le style ignore les paramètres CreateWindownWidth et nHeight ; le contrôle se dimensionne automatiquement pour prendre en charge l’icône. Comme il utilise la fonction LoadIcon , le style SS_ICON peut charger uniquement des icônes de dimensions SM_CXICON et SM_CYICON. Cette restriction peut être ignorée à l’aide du style SS_REALSIZEIMAGE en plus de SS_ICON.
Si une icône ne peut pas être chargée via LoadIcon, une tentative est effectuée pour charger la ressource spécifiée en tant que curseur à l’aide de LoadCursor. En cas d’échec, une tentative de chargement est effectuée à partir du pilote de périphérique à l’aide de LoadImage.
SS_LEFT
Un rectangle simple et aligne à gauche le texte dans le rectangle. Le texte est mis en forme avant son affichage. Les mots qui s’étendent au-delà de la fin d’une ligne sont automatiquement encapsulés au début de la ligne alignée à gauche suivante. Les mots qui sont plus longs que la largeur du contrôle sont tronqués.
SS_LEFTNOWORDWRAP
Un rectangle simple et aligne à gauche le texte 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 coupé.
SS_NOPREFIX
Empêche l’interprétation des caractères esperluette (&) dans le texte du contrôle en tant que caractères de préfixe d’accélérateur. Ceux-ci sont affichés avec l’esperluette supprimée et le caractère suivant dans la chaîne soulignée. Ce style de contrôle statique peut être inclus dans l’un des contrôles statiques définis. Vous pouvez combiner SS_NOPREFIX avec d’autres styles. Cela peut être utile lorsque des noms de fichiers ou d’autres chaînes pouvant contenir une esperluette (&) doivent être affichés dans un contrôle statique dans une boîte de dialogue.
SS_NOTIFY
Envoie la fenêtre parente STN_CLICKED, STN_DBLCLK, STN_DISABLE et STN_ENABLE codes de notification lorsque l’utilisateur clique ou double-clique sur le contrôle.
SS_OWNERDRAW
Le propriétaire du contrôle statique est chargé de dessiner le contrôle. La fenêtre propriétaire reçoit un message WM_DRAWITEM chaque fois que le contrôle doit être dessiné.
SS_PATHELLIPSIS
Remplace les caractères au milieu de la chaîne par des points de suspension afin que le résultat s’ajuste dans le rectangle spécifié. Si la chaîne contient des caractères inverses (\), SS_PATHELLIPSIS conserve autant que possible le texte après la dernière barre oblique inverse. L’utilisation de ce style forcera le texte du contrôle à se trouver sur une ligne sans retour à la ligne. Comparez-les aux SS_ENDELLIPSIS et aux SS_WORDELLIPSIS.
SS_REALSIZECONTROL
Ajuste la bitmap pour qu’elle corresponde à la taille du contrôle statique. Par exemple, la modification des paramètres régionaux peut modifier la police système, et ainsi, les contrôles peuvent être redimensionnés. Si un contrôle statique avait une bitmap, la bitmap ne correspond plus au contrôle. Ce bit de style détermine la redimensionnement automatique des bitmaps pour s’adapter à leurs contrôles.
Si SS_CENTERIMAGE est spécifié, l’image bitmap ou l’icône est centrée (et découpée si nécessaire). Si SS_CENTERIMAGE n’est pas spécifié, l’image bitmap ou l’icône est étirée ou réduite.
Notez que le redimensionnement dans les deux axes est indépendant et que le résultat peut avoir un rapport d’aspect modifié.
Comparez avec SS_REALSIZEIMAGE.
SS_REALSIZEIMAGE
Spécifie que la largeur réelle de la ressource est utilisée et que l’icône est chargée à l’aide de LoadImage. SS_REALSIZEIMAGE est toujours utilisé conjointement avec SS_ICON.
SS_REALSIZEIMAGE utilise LoadImage, en remplaçant le processus normalement suivi sous SS_ICON. Il ne charge pas de curseurs ; si LoadImage échoue, aucune autre tentative de chargement n’est effectuée. Elle utilise la largeur réelle des ressources. Le contrôle statique est redimensionné en conséquence, mais l’icône reste alignée sur les bords gauche et supérieur du contrôle spécifiés à l’origine.
Notez que si SS_CENTERIMAGE est également spécifié, l’icône est centrée dans l’espace du contrôle, qui a été spécifiée à l’aide des paramètres CreateWindownWidth et nHeight.
Comparez avec SS_REALSIZECONTROL.
SS_RIGHT
Un rectangle simple et aligne à droite le texte dans le rectangle. Le texte est mis en forme avant son affichage. Les mots qui s’étendent au-delà de la fin d’une ligne sont automatiquement encapsulés au début de la ligne alignée à droite suivante. Les mots qui sont plus longs que la largeur du contrôle sont tronqués.
SS_RIGHTJUST
L’angle inférieur droit d’un contrôle statique avec le style SS_BITMAP ou SS_ICON 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
Un rectangle simple et affiche une seule ligne de texte aligné à gauche dans le rectangle. La ligne de texte ne peut pas être raccourcie ou modifiée de quelque manière que ce soit. En outre, si le contrôle est désactivé, le contrôle ne grise pas son texte.
SS_SUNKEN
Dessine une bordure semi-enfoncée autour d’un contrôle statique.
SS_TYPEMASK
Bit de style composite qui résulte de l’utilisation de l’opérateur OR sur les bits de style SS_*. Peut être utilisé pour masquer les bits SS_* valides d’un masque de bits donné. Notez qu’il est obsolète et n’inclut pas correctement tous les styles valides. Par conséquent, vous ne devez pas utiliser ce style.
SS_WHITEFRAME
Zone avec un cadre dessiné avec la même couleur que l’arrière-plan de la fenêtre. Cette couleur est blanche dans le jeu de couleurs par défaut.
SS_WHITERECT
Rectangle rempli de la couleur d’arrière-plan de la fenêtre active. Cette couleur est blanche dans le jeu de couleurs par défaut.
SS_WORDELLIPSIS
Tronque tout mot qui ne tient pas dans le rectangle et ajoute des points de suspension. L’utilisation de ce style forcera le texte du contrôle à se trouver sur une ligne sans retour à la ligne.
Comparez avec SS_ENDELLIPSIS et SS_PATHELLIPSIS.

Notes

Pour utiliser un style qui tronque des mots ou des chaînes avec des points de suspension pour le texte multiligne, DrawThemeText ou DrawText peut être utilisé sur un contrôle de dessin propriétaire avec des indicateurs de mise en forme DT_WORDBREAK et DT_ENDELLIPSIS ensemble.

Configuration requise

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