TextOut显示文字的GDI函式

 TextOut是用於显示文字的最常用的GDI函式。语法是：
    TextOut (hdc, x, y, psText, iLength) ;
    以下将详细地讨论这个函式。
    第一个参数是装置内容代号，它既可以是GetDC的传回值，也可以是在处理WM_PAINT讯息时BeginPaint的传回值。
    装置内容的属性控制了被显示的字串的特徵。例如，装置内容中有一个属性指定文字颜色，内定颜色为黑色；内定装置内容还定义了白色的背景。在程式向显示器输出文字时，Windows使用这个背景色来填入字元周围的矩形空间（称为「字元框」）。
    该 文字背景色与定义视窗类别时设置的背景并不相同。视窗类别中的背景是一个画刷，它是一种纯色或者非纯色组成的画刷，Windows用它来擦除显示区域，它 不是装置内容结构的一部分。在定义视窗类别结构时，大多数Windows应用程式使用WHITE_BRUSH，以便内定装置内容中的内定文字背景颜色与 Windows用以擦除显示区域背景的画刷颜色相同。
    psText参数是指向字串的指标，iLength是字串中字元的个数。如果 psText指向Unicode字串，则字串中的位元组数就是iLength值的两倍。字串中不能包含任何ASCII控制字元（如回车、换行、制表或退 格），Windows会将这些控制字元显示为实心块。Text0ut不识别作为字串结束标志的内容为零的位元组（对於Unicode，是一个短整数型态的 0），而需要由nLength参数指明长度。
    TextOut中的x和y定义显示区域内字串的开始位置，x是水平位置，y是垂直位置。 字串中第一个字元的左上角位於座标点(x,y)。在内定的装置内容中，原点（x和y均为0的点）是显示区域的左上角。如果在TextOut中将x和y设为 0，则将从显示区域左上角开始输出字串。
    当您阅读GDI绘图函式（例如TextOut）的文件时，就会发现传递给函式的座标常常被称 为「逻辑座标」。在第五章会详细地解释这种情况。现在请注意，Windows有许多「座标映射方式」，它们用来控制GDI函式指定的逻辑座标转换为显示器 的实际图素座标的方式。映射方式在装置内容中定义，内定映射方式是MM_TEXT（使用WINGDI.H中定义的识别字）。在MM_TEXT映射方式下， 逻辑单位与实际单位相同，都是图素；x的值从左向右递增，y的值从上向下递增（参看图4-2）。MM_TEXT座标系与Windows在 PAINTSTRUCT结构中定义无效矩形时使用的座标系相同，这为我们带来了很多方便（但是，其他映射方式并非如此）。
    装置内容也 定义了一个剪裁区域。您已经看到，对於从GetDC取得的装置内容代号，内定剪裁区域是整个显示区域；而对於从BeginPaint取得的装置内容代号， 则为无效区域。Windows不会在剪裁区域之外的任何位置显示字串。如果一个字元有一部分在剪裁区域外，则Windows将只显示此区域内的那部分。要 想将输出写到视窗的显示区域之外不是那么容易的，所以不用担心会无意间出现这种事情。
    rel="File-List" href="file:///C:%5CDOCUME%7E1%5CJACKY_%7E1%5CLOCALS%7E1%5CTemp%5Cmsohtml1%5C01%5Cclip_filelist.xml">

LRESULT CALLBACK WndProc(HWND hWnd, UINT message, WPARAM wParam, LPARAM lParam)

{

         int wmId, wmEvent;

         PAINTSTRUCT ps;

         HDC hdc;

         TCHAR szHello[MAX_LOADSTRING];

         LoadString(hInst, IDS_HELLO, szHello, MAX_LOADSTRING);

 

         switch (message)

         {

         case WM_COMMAND:

                   wmId    = LOWORD(wParam);

                   wmEvent = HIWORD(wParam);

                   // Parse the menu selections:

                   switch (wmId)

                   {

                   case IDM_ABOUT:

                            DialogBox(hInst, (LPCTSTR)IDD_ABOUTBOX, hWnd, (DLGPROC)About);

                            break;

                   case IDM_EXIT:

                            DestroyWindow(hWnd);

                            break;

                   default:

                            return DefWindowProc(hWnd, message, wParam, lParam);

                   }

                   break;

         case WM_PAINT:

                   hdc = BeginPaint(hWnd, &ps);

                   // TODO: Add any drawing code here...

                   RECT rt;

                   GetClientRect(hWnd, &rt);

 

                   DrawText(hdc, szHello, strlen(szHello), &rt, DT_LEFT);

 

                   //TextOut WINGDI.h

                   //WINGDIAPI BOOL  WINAPI TextOutA(HDC, int, int, LPCSTR, int);

                   //WINGDIAPI BOOL  WINAPI TextOutW(HDC, int, int, LPCWSTR, int);

                   TextOut(hdc, 0, 15, szHello, strlen(szHello));

 

                   EndPaint(hWnd, &ps);

                   break;

         case WM_DESTROY:

                   PostQuitMessage(0);

                   break;

         default:

                   return DefWindowProc(hWnd, message, wParam, lParam);

         }

         return 0;

}