Windows程序设计--文本输出(二)

今天要详细讲解一下TEXTOUT，它是显示文本最重要的GDI函数。CSDN是这样描述的：

The TextOut function writes a character string at the specified location, using the currently selected font, background color, and text color.

我们看看他的原型：

BOOL TextOut(
_In_ HDC     hdc,
_In_ int     nXStart,
_In_ int     nYStart,
_In_ LPCTSTR lpString,
_In_ int     cchString
);

第一个参数就是设备环境句柄；

第二第三个参数决定了输出字符串在客户区的起始位置，注意的是该坐标为逻辑坐标，是相对于client的；

第四个参数是指向字符串的指针；

第五个参数是字符串中的字符数。

下面是简单应用：

// Obtain the window's client rectangle
GetClientRect(hwnd, &r);

// THE FIX: by setting the background mode
// to transparent, the region is the text itself
// SetBkMode(hdc, TRANSPARENT);

// Bracket begin a path
BeginPath(hdc);

// Send some text out into the world
TCHAR text[ ] = "Defenestration can be hazardous";
TextOut(hdc,r.left,r.top,text, ARRAYSIZE(text));

// Bracket end a path
EndPath(hdc);

// Derive a region from that path
SelectClipPath(hdc, RGN_AND);

// This generates the same result as SelectClipPath()
// SelectClipRgn(hdc, PathToRegion(hdc));

// Fill the region with grayness
FillRect(hdc, &r, GetStockObject(GRAY_BRUSH));

TextOut函数完成了文本的输出，但是输出文本的字体、大小等属性却不是由TextOut来控制的，还是需要我们之前所说的设备环境。

那接下来不得不提就是函数GetTextMetrics，该函数把程序当前的字体信息，存放到TEXTMETRIC中。

TEXTMETRIC又是什么鬼？

windows把字符尺寸的各种值复制到类型为TEXTMETRIC的结构中。这个结构体有20个字段，我们关心几个；

typedef struct tagTEXTMETRIC { /* tm */
int tmHeight; //字符高度
int tmAscent; //字符上部高度
int tmDescent; //字符下部高度
int tmInternalLeading;//由tmHeight定义的字符高度的顶部空间数目
int tmExternalLeading;//夹在两行之间的空间数目
int tmAveCharWidth;  //平均字符宽度
int tmMaxCharWidth;//最宽字符的宽度
...
} TEXTMETRIC;

注意tmHeight = tmAscent+tmDescent。

现在是时候看下函数GetTextMetrics了，原型如下：

BOOL GetTextMetrics(HDC hdc, LPTEXTMETRIC lptm)；

hdc：设备环境句柄。

lptm：指向结构TEXTMETRIC的指针，该结构用于获得字体信息。

返回值：如果函数调用成功，返回值非零，如果函数调用失败，返回值是0。

TEXTMETRIC tm;
hdc = GetDc(hwnd);

GetTextMetrics(hdc, &tm);

TextOut();