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.

Constante	Description
SS_BITMAP	Une bitmap doit être affichée dans le contrôle statique. Le texte est le nom d’une bitmap (et non 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é dans 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 du cadre de la fenêtre active. 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 d’être affiché. 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 dont la longueur est supérieure à la largeur du contrôle sont tronqués.
SS_CENTERIMAGE	Une bitmap est centrée dans le contrôle statique qui la contient. Le contrôle n’est pas redimensionné, de sorte qu’une bitmap trop grande pour le contrôle est clippé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 de 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 des points de suspension sont ajoutés. Si un mot qui ne se trouve pas à la fin de la chaîne dépasse les limites du rectangle, il est tronqué sans ellipses. L’utilisation de ce style force le texte du contrôle à se trouver sur une seule 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érieur et inférieur 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	Une 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 de la couleur d’arrière-plan de l’écran actuel. 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 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 contournée en utilisant le 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. Si cela échoue également, une tentative de chargement à partir du pilote de périphérique est effectuée à l’aide de LoadImage.
SS_LEFT	Un rectangle simple et aligne à gauche le texte dans le rectangle. Le texte est mis en forme avant d’être affiché. 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 dont la longueur est supérieure à 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. Celles-ci s’affichent avec l’esperluette supprimée et le caractère suivant dans la chaîne souligné. 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. 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 responsable du dessin du 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 corresponde au rectangle spécifié. Si la chaîne contient des caractères barre oblique inverse (\), SS_PATHELLIPSIS conserve autant que possible le texte après la dernière barre oblique inverse. L’utilisation de ce style force le texte du contrôle à se trouver sur une seule ligne sans retour à la ligne. Comparez avec SS_ENDELLIPSIS et SS_WORDELLIPSIS.
SS_REALSIZECONTROL	Ajuste la bitmap pour l’adapter à la taille du contrôle statique. Par exemple, la modification des paramètres régionaux peut modifier la police système et, par conséquent, les contrôles peuvent être redimensionnés. Si un contrôle statique avait une bitmap, la bitmap ne s’adapterait plus au contrôle. Ce bit de style dicte le redimensionnement automatique des bitmaps en fonction de leurs contrôles. Si SS_CENTERIMAGE est spécifié, la bitmap ou l’icône est centrée (et coupée si nécessaire). Si SS_CENTERIMAGE n’est pas spécifié, la 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 de ressource réelle 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 les curseurs ; si LoadImage échoue, aucune autre tentative de chargement n’est effectuée. Il utilise la largeur de ressource réelle. Le contrôle statique est redimensionné en conséquence, mais l’icône reste alignée sur les bords gauche et supérieur spécifiés à l’origine du contrôle. 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é à 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 d’être affiché. 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	Le coin 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 icône.
SS_SIMPLE	Rectangle simple et affiche une seule ligne de texte aligné à gauche dans le rectangle. La ligne de texte ne peut en aucun cas être raccourcie ou modifiée. En outre, si le contrôle est désactivé, il ne grise pas son texte.
SS_SUNKEN	Dessine une bordure à moitié 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 SS_* bits de style. Peut être utilisé pour masquer les bits SS_* valides d’un masque de bits donné. Notez que ce n’est pas à jour et qu’il 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 actuelle. 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 force le texte du contrôle à se trouver sur une ligne sans habillage de mot. 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 du texte multiligne, DrawThemeText ou DrawText peuvent être utilisés sur un contrôle de dessin propriétaire avec des indicateurs de mise en forme DT_WORDBREAK et DT_ENDELLIPSIS définis.

Spécifications

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 (inclure Windows.h)