Barre d’état

Cette section contient des informations sur les éléments de programmation utilisés avec les contrôles de barre d’état.

Aperçus

Sujet	Contenu
barres d’état	Une barre d’état est une fenêtre horizontale située en bas d’une fenêtre parente dans laquelle une application peut afficher différents types d’informations d’état.

Fonctions

Sujet	Contenu
CreateStatusWindow	Crée une fenêtre d’état, généralement utilisée pour afficher l’état d’une application. La fenêtre apparaît généralement en bas de la fenêtre parente et contient le texte spécifié. Remarque : cette fonction est obsolète. Utilisez CreateWindow à la place.
DrawStatusText	La fonction DrawStatusText dessine le texte spécifié dans le style d’une fenêtre d’état avec des bordures.
MenuHelp	Traite WM_MENUSELECT et WM_COMMAND messages et affiche le texte d’aide sur le menu actif dans la fenêtre d’état spécifiée.

Messages

Sujet	Contenu
SB_GETBORDERS	Récupère les largeurs actuelles des bordures horizontales et verticales d’une fenêtre d’état.
SB_GETICON	Récupère l’icône d’une partie dans une barre d’état.
SB_GETPARTS	Récupère le nombre de parties dans une fenêtre d’état. Le message récupère également la coordonnée du bord droit du nombre spécifié de parties.
SB_GETRECT	Récupère le rectangle englobant d’une partie dans une fenêtre d’état.
SB_GETTEXT	Le message SB_GETTEXT récupère le texte de la partie spécifiée d’une fenêtre d’état.
SB_GETTEXTLENGTH	Le message SB_GETTEXTLENGTH récupère la longueur, en caractères, du texte de la partie spécifiée d’une fenêtre d’état.
SB_GETTIPTEXT	Récupère le texte de l’info-bulle d’une partie dans une barre d’état. La barre d’état doit être créée avec le style SBT_TOOLTIPS pour activer les info-bulles.
SB_GETUNICODEFORMAT	Récupère l’indicateur de format de caractère Unicode pour le contrôle.
SB_ISSIMPLE	Vérifie un contrôle de barre d’état pour déterminer s’il est en mode simple.
SB_SETBKCOLOR	Définit la couleur d’arrière-plan dans une barre d’état.
SB_SETICON	Définit l’icône d’une partie dans une barre d’état.
SB_SETMINHEIGHT	Définit la hauteur minimale de la zone de dessin d’une fenêtre d’état.
SB_SETPARTS	Définit le nombre de parties dans une fenêtre d’état et la coordonnée du bord droit de chaque partie.
SB_SETTEXT	Le message SB_SETTEXT définit le texte dans la partie spécifiée d’une fenêtre d’état.
SB_SETTIPTEXT	Définit le texte de l’info-bulle d’une partie dans une barre d’état. La barre d’état doit avoir été créée avec le style SBT_TOOLTIPS pour activer les info-bulles.
SB_SETUNICODEFORMAT	Définit l’indicateur de format de caractère Unicode pour le contrôle. Ce message vous permet de modifier le jeu de caractères utilisé par le contrôle au moment de l’exécution plutôt que de devoir recréer le contrôle.
SB_SIMPLE	Spécifie si une fenêtre d’état affiche du texte simple ou affiche toutes les parties de fenêtre définies par un message SB_SETPARTS précédent.

Notifications

Sujet	Contenu
NM_CLICK (barre d’état)	Avertit la fenêtre parente d’un contrôle de barre d’état que l’utilisateur a cliqué sur le bouton gauche de la souris dans le contrôle. NM_CLICK (barre d’état) est envoyé sous la forme d’un message WM_NOTIFY.
NM_DBLCLK (barre d’état)	Avertit la fenêtre parente d’un contrôle de barre d’état que l’utilisateur a double-cliqué sur le bouton gauche de la souris dans le contrôle. Cette notification est envoyée sous la forme d’un message WM_NOTIFY.
NM_RCLICK (barre d’état)	Avertit la fenêtre parente d’un contrôle de barre d’état que l’utilisateur a cliqué sur le bouton droit de la souris dans le contrôle. Cette notification est envoyée sous la forme d’un message WM_NOTIFY.
NM_RDBLCLK (barre d’état)	Avertit les fenêtres parentes d’un contrôle de barre d’état que l’utilisateur a double-cliqué sur le bouton droit de la souris dans le contrôle. NM_RDBLCLK (barre d’état) est envoyé sous la forme d’un message WM_NOTIFY.
SBN_SIMPLEMODECHANGE	Envoyé par un contrôle de barre d’état lorsque le mode simple change en raison d’un message SB_SIMPLE. Cette notification est envoyée sous la forme d’un message WM_NOTIFY.

Constantes

Sujet	Contenu
Styles de barre d’état	Cette section répertorie les styles, en plus des styles de fenêtre standard, pris en charge par barre d’état contrôles.