DrawStatusTextA, fonction (commctrl.h)

Article
11/18/2024

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

Syntaxe

void DrawStatusTextA(
  HDC     hDC,
  LPCRECT lprc,
  LPCSTR  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, dans les 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 de tabulation de 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 les bordures d’être dessinées autour du texte spécifié.
SBT_POPOUT	Dessine les bordures en surbrillance qui font ressortir le texte.
SBT_RTLREADING	Indique que la chaîne pointée par pszText s’affiche dans la direction opposée au texte de la fenêtre parente.

Valeur de retour

Aucun

Remarques

Les fenêtres normales affichent le texte de gauche à droite (LTR). Windows peut être mise 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 la direction opposée du texte de la fenêtre parente.

Note

L’en-tête commctrl.h définit DrawStatusText comme 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.

Exigences

Exigence	Valeur
client minimum pris en charge	Windows Vista [applications de bureau uniquement]
serveur minimum pris en charge	Windows Server 2003 [applications de bureau uniquement]
plateforme cible	Windows
d’en-tête	commctrl.h
bibliothèque	Comctl32.lib
DLL	Comctl32.dll

Partager via