GrayStringA, fonction (winuser.h)

Article
11/20/2024

La fonction GrayString dessine du texte gris à l’emplacement spécifié. La fonction dessine le texte en le copiant dans une bitmap de mémoire, en grisant la bitmap, puis en copiant la bitmap à l’écran. La fonction grise le texte indépendamment du pinceau et de l’arrière-plan sélectionnés. GrayString utilise la police actuellement sélectionnée pour le contexte d’appareil spécifié.

Si thelpOutputFuncparameter est NULL, GDI utilise la fonction TextOut, et lelpDataparameter est supposé être un pointeur vers la chaîne de caractères à générer. Si les caractères à générer ne peuvent pas être gérés par TextOut (par exemple, la chaîne est stockée en tant que bitmap), l’application doit fournir sa propre fonction de sortie.

Syntaxe

BOOL GrayStringA(
  [in] HDC            hDC,
  [in] HBRUSH         hBrush,
  [in] GRAYSTRINGPROC lpOutputFunc,
  [in] LPARAM         lpData,
  [in] int            nCount,
  [in] int            X,
  [in] int            Y,
  [in] int            nWidth,
  [in] int            nHeight
);

Paramètres

[in] hDC

Handle vers le contexte de l’appareil.

[in] hBrush

Poignée à utiliser pour le grisage. Si ce paramètre est NULL, le texte est grisé avec le même pinceau utilisé pour dessiner du texte de fenêtre.

[in] lpOutputFunc

Pointeur vers la fonction définie par l’application qui dessine la chaîne ou, si TextOut doit être utilisé pour dessiner la chaîne, il s’agit d’un pointeur NULL. Pour plus d’informations, consultez la fonction de rappel OutputProc.

[in] lpData

Pointeur vers les données à passer à la fonction de sortie. Si le paramètre lpOutputFunc est NULL, lpData doit être un pointeur vers la chaîne à générer.

[in] nCount

Nombre de caractères à générer. Si le paramètre nCount est égal à zéro, GrayString calcule la longueur de la chaîne (en supposant que lpData est un pointeur vers la chaîne). Si nCount est 1 et que la fonction pointée par lpOutputFunc retourne FALSE, l’image est affichée, mais pas grisée.

[in] X

Coordonnée x de l’appareil de la position de départ du rectangle qui entoure la chaîne.

[in] Y

Coordonnée y de l’appareil de la position de départ du rectangle qui entoure la chaîne.

[in] nWidth

Largeur, en unités d’appareil, du rectangle qui entoure la chaîne. Si ce paramètre est égal à zéro, GrayString calcule la largeur de la zone, en supposant que lpData est un pointeur vers la chaîne.

[in] nHeight

Hauteur, en unités d’appareil, du rectangle qui entoure la chaîne. Si ce paramètre est égal à zéro, GrayString calcule la hauteur de la zone, en supposant que lpData est un pointeur vers la chaîne.

Valeur de retour

Si la chaîne est dessinée, la valeur de retour est différente de zéro.

Si la fonction TextOut ou la fonction de sortie définie par l’application a retourné zéro, ou si la mémoire est insuffisante pour créer une bitmap de mémoire pour le grisage, la valeur de retour est égale à zéro.

Remarques

Sans appeler GrayString, une application peut dessiner des chaînes grisées sur les appareils qui prennent en charge une couleur grise unie. La couleur système COLOR_GRAYTEXT est la couleur système unie-gris utilisée pour dessiner du texte désactivé. L’application peut appeler la fonction GetSysColor pour récupérer la valeur de couleur de COLOR_GRAYTEXT. Si la couleur est différente de zéro (noir), l’application peut appeler la fonction SetTextColor pour définir la couleur de texte sur la valeur de couleur, puis dessiner la chaîne directement. Si la couleur récupérée est noire, l’application doit appeler GrayString pour griser le texte.

Note

L’en-tête winuser.h définit GrayString en tant qu’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 2000 Professionnel [applications de bureau uniquement]
serveur minimum pris en charge	Windows 2000 Server [applications de bureau uniquement]
plateforme cible	Windows
d’en-tête	winuser.h (include Windows.h)
bibliothèque	User32.lib
DLL	User32.dll