Fonction DrawStatusTextW (commctrl.h)

Article
03/04/2024

La fonction DrawStatusText dessine le texte spécifié dans le style d’une fenêtre status avec des bordures.

Syntaxe

void DrawStatusTextW(
  HDC     hDC,
  LPCRECT lprc,
  LPCWSTR pszText,
  UINT    uFlags
);

Paramètres

hDC

Type : HDC

Gérez le contexte d’affichage de la fenêtre.

lprc

Type : LPCRECT

Pointeur vers une structure RECT qui contient la position, en coordonnées clientes, du rectangle dans lequel le texte est dessiné. La fonction dessine les bordures juste à l’intérieur des bords du rectangle spécifié.

pszText

Type : LPCTSTR

Pointeur vers une chaîne terminée par null qui spécifie le texte à afficher. Les caractères tabulation dans la chaîne déterminent si la chaîne est alignée à gauche, alignée à droite ou centrée.

uFlags

Type : UINT

Indicateurs de dessin de texte. Ce paramètre peut être une combinaison de ces valeurs :

Valeur	Signification
SBT_NOBORDERS	Empêche le dessin de bordures autour du texte spécifié.
SBT_POPOUT	Dessine les bordures en surbrillance qui distinguent le texte.
SBT_RTLREADING	Indique que la chaîne pointée vers pszText sera affichée dans la direction opposée au texte dans la fenêtre parente.

Valeur de retour

None

Remarques

Les fenêtres normales affichent le texte de gauche à droite (LTR). Windows peut être mis en miroir pour afficher des langues telles que l’hébreu ou l’arabe qui lisent de droite à gauche (RTL). Normalement, la chaîne pszText s’affiche dans la même direction que le texte dans sa fenêtre parente. Si SBT_RTLREADING est défini, la chaîne pszText lit dans le sens inverse du texte de la fenêtre parente.

Notes

L’en-tête commctrl.h définit DrawStatusText comme un alias qui sélectionne automatiquement la version ANSI ou Unicode de cette fonction en fonction de la définition de la constante de préprocesseur UNICODE. Le mélange de l’utilisation de l’alias neutre en encodage avec du code qui n’est pas neutre en encodage peut entraîner des incompatibilités qui entraînent des erreurs de compilation ou d’exécution. Pour plus d’informations, consultez Conventions pour les prototypes de fonction.

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]
Plateforme cible	Windows
En-tête	commctrl.h
Bibliothèque	Comctl32.lib
DLL	Comctl32.dll

Partager via