CDC::GrayString

项目
03/01/2013

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 调用，并且，回调函数没有调用。