Remarque
L’accès à cette page nécessite une autorisation. Vous pouvez essayer de vous connecter ou de modifier des répertoires.
L’accès à cette page nécessite une autorisation. Vous pouvez essayer de modifier des répertoires.
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 | Descriptif |
|---|---|
|
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. |
|
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. |
|
Rectangle rempli de la couleur de cadre de fenêtre actuelle. Cette couleur est noire dans le jeu de couleurs par défaut. |
|
Un 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 plus longs que la largeur du contrôle sont tronqués. |
|
Une bitmap est centrée dans le contrôle statique qui le contient. Le contrôle n’est pas redimensionné, de sorte qu’une bitmap trop grande pour le contrôle sera rognée. Si le contrôle statique contient une seule ligne de texte, le texte est centré verticalement dans la zone cliente du contrôle. |
|
Le contrôle statique doublons 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. |
|
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 encapsuler le mot. Comparez avec SS_PATHELLIPSIS et SS_WORDELLIPSIS. |
|
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. |
|
Dessine le cadre du contrôle statique à l’aide du style de bord EDGE_ETCHED . Pour plus d’informations, consultez la fonction DrawEdge . |
|
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 . |
|
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 . |
|
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. |
|
Rectangle rempli de la couleur d’arrière-plan de l’écran actuelle. Cette couleur est grise dans le jeu de couleurs par défaut. |
|
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 dans 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. Si cela échoue également, une tentative de chargement à partir du pilote de périphérique à l’aide de LoadImage est effectuée. |
|
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 plus longs que la largeur du contrôle sont tronqués. |
|
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 clippé. |
|
Empêche l’interprétation de tous les caractères d’ampersand (&) dans le texte du contrôle en tant que caractères de préfixe d’accélérateur. Celles-ci sont affichées avec l’ampersand supprimé et le caractère suivant dans la chaîne soulignée. 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 qui peuvent contenir un ampersand (&) doivent être affichés dans un contrôle statique dans une boîte de dialogue. |
|
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. |
|
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é. |
|
Remplace les caractères au milieu de la chaîne par des points de suspension afin que le résultat s’intègre 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 encapsuler le mot. Comparez avec SS_ENDELLIPSIS et SS_WORDELLIPSIS. |
|
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 correspondrait 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 clippé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 la redimensionnement dans les deux axes est indépendante et que le résultat peut avoir un rapport d’aspect modifié. Comparez avec 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 les 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. |
|
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 plus longs que la largeur du contrôle sont tronqués. |
|
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. |
|
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. |
|
Dessine une bordure semi-enfoncée autour d’un contrôle statique. |
|
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 s’agit d’une date obsolète et n’inclut pas correctement tous les styles valides. Par conséquent, vous ne devez pas utiliser ce style. |
|
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. |
|
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. |
|
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 encapsuler le mot. Comparez avec SS_ENDELLIPSIS et SS_PATHELLIPSIS. |
Remarques
Pour utiliser un style qui tronque des mots ou des chaînes avec des points de suspension pour du 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.
Spécifications
| Besoin | Valeur |
|---|---|
| Client minimum pris en charge |
Windows Vista [applications de bureau uniquement] |
| Serveur minimum pris en charge |
Windows Server 2003 [applications de bureau uniquement] |
| En-tête de page |
|