virtuelBOOLGrayString (CBrush *pBrush,,BOOL()rappelexportation *lpfnOutput) (HDC,LPARAM,int),LPARAMlpData,intnCount,intx,inty,intnWidth,intnHauteur);
Valeur de retour
Différent de zéro si la chaîne est dessinée, ou 0 si la fonction TextOut ou la fonction de sortie fournie par l'application retourne 0, ou s'il y a assez de mémoire pour créer un bitmap en mémoire de gradation.
Paramètres
pBrush
Identifie le pinceau à utiliser pour la gradation (vieillissement).
lpfnOutput
Spécifie l'adresse de l'instance de procédure de la fonction de rappel fournie par l'application qui tirera parti de la chaîne. Pour plus d'informations, voir la description de lafonction de rappelde Windows OutputFunc. Si ce paramètre est NULL, le système utilise la fonction Windows TextOut pour dessiner la chaîne, et lpData est supposé pour être un pointeur long de la chaîne de caractères de sortie .
lpData
Spécifie un pointeur far aux données d'être transmis à la fonction de sortie. Si lpfnOutput est NULL, lpData doit être un pointeur long de la chaîne de production.
nCount
Spécifie le nombre de caractères à être sortie. Si ce paramètre est 0, GrayString calcule la longueur de la chaîne (en supposant que lpData est un pointeur vers la chaîne). Si nCount est – 1, et la fonction lpfnOutput renvoie la valeur 0, l'image est indiqué mais pas estompé.
x
Spécifie la coordonnée x logique de la position de départ du rectangle qui entoure la chaîne.
y
Spécifie la coordonnée y logique de la position de départ du rectangle qui entoure la chaîne.
nLargeur
Spécifie la largeur (en unités logiques) du rectangle qui entoure la chaîne. Si nLargeur est 0, GrayString calcule la largeur de la zone, en supposant que lpData est un pointeur vers la chaîne.
nHauteur
Spécifie la hauteur (en unités logiques) du rectangle qui entoure la chaîne. Si nHauteur est 0, GrayString calcule la hauteur de la zone, en supposant que lpData est un pointeur vers la chaîne.
Remarques
Tirages s'est estompée (gris) texte à l'endroit donné par écrit le texte dans un bitmap en mémoire, l'image bitmap de gradation et puis en copiant l'image bitmap à l'écran. La fonction efface le texte indépendamment de la brosse sélectionnée et l'arrière-plan. La fonction de membre GrayString utilise la police sélectionnée. Le mode de mappage MM_TEXT doit être sélectionné avant d'utiliser cette fonction.
Une application peut dessiner grisés de chaînes (estompés) sur les périphériques qui prennent une couleur grise solide sans appeler la fonction membre GrayString . La couleur du système COLOR_GRAYTEXT est la couleur gris-solide système utilisée pour dessiner le texte désactivé. L'application peut appeler la fonction Windows GetSysColor pour récupérer la valeur de couleur de COLOR_GRAYTEXT. Si la couleur est de 0 (noir), l'application peut appeler la fonction membre SetTextColor pour définir la couleur du texte à la valeur de la couleur et puis dessinez la chaîne directement. Si l'extrait est noire, l'application doit appeler GrayString pour dim (gris) le texte.
Si lpfnOutput est NULL, GDI utilise le Windows la fonction TextOut et lpData est supposé pour être un pointeur far vers le personnage à être sortie. Si les caractères de sortie ne peut pas être gérées par la fonction membre TextOut (par exemple, la chaîne est stockée comme une image bitmap), l'application doit fournir sa propre fonction de sortie.
Notez également que toutes les fonctions de rappel doivent intercepter des exceptions Microsoft Foundation avant de retourner à Windows, étant donné que les exceptions ne peuvent être levées au-delà des frontières de rappel. Pour plus d'informations sur les exceptions, consultez l'article Exceptions dans le Guide du programmeur Visual C++.
La fonction de rappel transmise à GrayString doit utiliser la __stdcall convention d'appel et doit être exportée avec __declspec.
Lorsque le cadre est en mode de prévisualisation, un appel à la fonction membre GrayString est traduit un appel TextOut , et le rappel de la fonction n'est pas appelée.
Aperçu de la CDC | ; Membres de la classe | Graphique de la hiérarchie
Voir aussinbsp ; :: GetSysColor, CDC::SetTextColor, CDC::TextOut, :: GrayString