CDC::GrayString

draws在给定位置为灰色了(灰色)文本通过将文本在内存位图,为灰色位图,然后复制位图传递给显示。

virtual BOOL GrayString(
   CBrush* pBrush,
   BOOL ( CALLBACK* lpfnOutput )( HDC, LPARAM, int ),
   LPARAM lpData,
   int nCount,
   int x,
   int y,
   int nWidth,
   int nHeight
);

参数

  • pBrush
    标识为灰显要使用的画笔(这种情况)。

  • lpfnOutput
    指定要绘制该字符串由应用程序提供的回调函数的程序实例地址。 有关更多信息,请参见Windows OutputFunc 回调函数的说明。 如果此参数是 NULL,系统使用Windows TextOut 功能绘制该字符串,并且,lpData 假定为较长的指针为的字符字符串输出。

  • lpData
    指定较指针将传递的数据输出功能。 如果 lpfnOutput 是 NULL,lpData 必须是较长的指针为中的字符串输出。

  • nCount
    指定字符数是输出。 如果此参数是0,GrayString 计算该字符串的长度(假定,lpData 是指向该字符串)。 如果 nCount 为– 1和函数指向由 lpfnOutput 返回0;该图像显示,但没有为灰色。

  • x
    指定矩形的起始位置的逻辑x坐标将该字符串。

  • y
    指定矩形的起始位置的逻辑y坐标将该字符串。

  • nWidth
    指定宽度(以逻辑单位将该字符串)的矩形。 如果 nWidth 为0,GrayString 计算区域的宽度,假定 lpData 是指向该字符串。

  • nHeight
    指定高度(以逻辑单位将该字符串)矩形。 如果 nHeight 为0,GrayString 计算面积的高度,假定 lpData 是指向该字符串。

返回值

非零,则绘制该字符串或0,则 TextOut 函数或由应用程序提供的输出函数返回0;或者,如果具有创建灰显的一个内存位图的内存不足。

备注

无论选定的画笔和背景,该功能为灰色该文本。 GrayString 成员函数使用当前选定的字体。 必须在使用此功能之前选择映射方案的 MM_TEXT

应用程序可以绘制在支持内置的灰色颜色,而不调用 GrayString 成员函数的计算机上灰显(灰色)字符串。 系统颜色 COLOR_GRAYTEXT 是用于内置的灰色系统颜色绘制禁用文本。 应用程序可以调用 GetSysColor Windows函数检索 COLOR_GRAYTEXT的颜色值。 如果颜色为0以外(黑色),应用程序可以调用 SetTextColor 成员函数上设置文本颜色更改为颜色值直接然后绘制该字符串。 如果已检索的颜色为黑色,应用程序必须调用 GrayString 灰显(灰色)该文本。

如果 lpfnOutput 是 NULL,GDI使用Windows TextOut 功能,并且,lpData 假定是较指向是字符输出。 如果是字符输出不能由 TextOut 成员函数处理(例如,字符串存储为位图),应用程序必须提供自己的输出函数。

另外请注意所有回调函数必须在返回之前捕获Microsoft基础异常。Windows中,因为异常不能在回调边界时引发。 有关异常的更多信息,请参见文章 异常

回调函数传递给 GrayString 必须使用调用约定 __stdcall,并且必须导出与 __declspec。

当框架在预览模式时,对 GrayString 成员函数的调用将转换为 TextOut 调用,并且,回调函数没有调用。

要求

Header: afxwin.h

请参见

参考

CDC 类

层次结构图

GetSysColor

CDC::SetTextColor

CDC::TextOut

GrayString