当前位置:C++技术网 > 资讯 > TextOut如何显示多行文本,TextOut函数使用全面分析

TextOut如何显示多行文本,TextOut函数使用全面分析

更新时间:2016-01-10 13:43:57浏览次数:1+次

    一开始我也很不明白,为什么TextOut函数不支持自动换行和不支持多行显示。后来仔细观察了它的参数特点,慢慢也想明白了原因。
    先来看看TextOut函数的声明:
BOOL TextOut(HDC hdc,int nXStart,int nYStart,LPCTSTR lpString,int cbString);
    函数需要输出文字的xy坐标,需要字符串地址,需要字符个数。从xy坐标的参数,我们可以看出,TextOut函数支持在坐标系中的任何位置输出。我们对于坐标的获取是非常方便的,很多消息的参数中就已经含了坐标。而且有了这个坐标参数,我们可以根据自己的需要随意的计算和处理。这是这个坐标值给我们的自由。
    字符个数的参数,如果为小于等于0,则不会有任何字符输出。而DrawText函数可以使用-1来自动寻找字符的结尾。但是TextOut函数却不能。TextOut函数是最基本的文字输出函数,应该来说是很基础的函数。所以,函数给予我们很少的功能的支持,比如不能支持多行自动换行,没有所谓的文字对齐方式。TextOut所能给的就是简单的输出文字而已。
    也正是这个基础的函数,在我们很多地方输出文字的时候,就显得很自由了。反而函数予以太多的功能,将会导致我们行为不便,需要注意很多的规则。而这些规则也是函数封装了基础的函数得来的。如果我们想自定义,就比较麻烦。
    然而,我们确实想用TextOut函数来输出多行的文本。如何做呢?

    多行,那就用多个TextOut来输出咯。这不是很简单的事情吗?对于TextOut函数,没有其他办法,下面是输入\r、\n和\r\n字符串的输出【C++技术网www.cjjjs.com】结果:

TextOut输出\r的效果

【TextOut输出\r的效果】

TextOut输出\n的效果

【TextOut输出\n的效果】

TextOut输出\r\n的效果

【TextOut输出\r\n的效果】
    可以看到TextOut确实不支持这三个换行方式。也就表示它不支持换行。如果你要换行,你将C++技术网和www.cjjjs.com做两次输出即可。
    为了确定最合适的行距,所以我们要获取字体的信息,调用的函数为GetTextMetrics,获得的字体信息结构体tm的tmHeight成员就是字符的高度了。这个高度就可以作为字符的间距了。
    第一行从y=0的坐标输出,那么第二行就从y=tm.tmHeight的地方输出。不要自己去输入y的值,这样是不可取的。如果你换一个字体后,那么这个高度也就变了,你之前设置的第二行的输入高度,就变了,那就要重新改代码了。

    两行输出的结果就是下面这样的,也是我们需要的样子了。效果如下图所示:

TextOut两行输出文字的效果

【TextOut两行输出文字的效果】
    这样就完了吗?没有!我曾思考,TextOut在超过右边的边框或者遇到换行符,如何支持换行呢?既然TextOut是直接输出,没有其他办法,我们就只有迁就于它。那么我们要换行显示,还是只能调用TextOut函数多次,计算每次输出需要的正确的xy坐标和字符长度。客户区有多宽我们知道,字符串长度我们知道,计算字符串的宽度,如果宽度大于等于客户区的宽度,就要将超出的字符串放在下一行输出。如果字符串中遇到了\r、\n或\r\n,你就要将字符串拆开,然后分成前后两段字符串来处理。
    这一切都是我们程序来处理的。TextOut只简单的输出文字而已。其他的格式之类的控制,全部要由我们程序实现处理好。而这一点,是我一直对TextOut的功能没有了解清楚,以至于浪费了很多时间。
    之所以这么仔细的写出来,无非就是让你深刻的明白这一点,然后不要为此再浪费时间了。当然,也给大家提供了一个可行的多行显示和换行输出的方案。如果你对于字符宽度不太会处理,使用等宽字体就好了。如果你要实现等宽字体的字符宽度的计算,请参考《win32混合中英文字符时准确定位插入符(光标) 》。
    下面是本文的完整代码:
#include "windows.h"
#include <tchar.h>
TCHAR txt[100]=_T("C++技术网www.cjjjs.com");
// - 项目是Unicode字符集
LRESULT CALLBACK WinProc(HWND hwnd,UINT message,WPARAM wParam,LPARAM lParam)
{
    HDC hdc;
    PAINTSTRUCT ps;
    TEXTMETRIC tm;
    switch (message)
    {
        case WM_PAINT:
            {
                hdc = BeginPaint(hwnd,&ps);
                SelectObject(hdc,GetStockObject(SYSTEM_FIXED_FONT));
                int len = lstrlen(txt);
                TextOut(hdc,0,0,txt,6);
                GetTextMetrics(hdc,&tm);
                TextOut(hdc,0,tm.tmHeight,txt+6,len-6);
                EndPaint(hwnd,&ps);
                return 0;
            }
        case WM_DESTROY:
            PostQuitMessage(0); 
            return 0;
        default:
        break;//跳出到默认处理
    }
    return DefWindowProc(hwnd, message, wParam, lParam);
}

int WINAPI WinMain(HINSTANCE hInstance,HINSTANCE hPrev,LPSTR lpCmd,int iShow)
{
    TCHAR ClassName[] = _T("MyClass");
    TCHAR title1[] = _T("C++技术网http://www.cjjjs.com");
    WNDCLASS wndClass;
    wndClass.cbClsExtra=0;
    wndClass.cbWndExtra=0;
    wndClass.hbrBackground= (HBRUSH)GetStockObject(WHITE_BRUSH);
    wndClass.hCursor=LoadCursor(NULL,IDC_HAND);
    wndClass.hIcon=LoadIcon(NULL,IDI_APPLICATION);
    wndClass.hInstance = hInstance;
    wndClass.lpfnWndProc = WinProc;
    wndClass.lpszClassName = ClassName;
    wndClass.lpszMenuName=NULL;
    wndClass.style=CS_HREDRAW|CS_VREDRAW;

    if(!RegisterClass(&wndClass))return 0;
    HWND hwnd = CreateWindow(ClassName,title1,WS_OVERLAPPEDWINDOW,0,0,350,400,NULL,NULL,hInstance,NULL);
    ShowWindow(hwnd,SW_SHOWNORMAL);

    MSG msg;
    while (GetMessage(&msg,NULL,0,0))
    {
        TranslateMessage(&msg);
        DispatchMessage(&msg);
    }
    return msg.wParam;
}