C语言Windows程序开发—TextOut函数介绍【第02天】

（一）TextOut函数的参数介绍：

 BOOL TextOut (                  //如果函数调用成功，返回TRUE，否则，返回FALSE
     HDC         hdc,            //用于显示字符串的控件ID
     int         nXStart,        //字符串所在起始位置左上角（X,Y）的X坐标
     int         nYStart,        //字符串所在起始位置左上角（X,Y）的Y坐标
     LPCTSTR     lpString,       //显示的字符串内容
     int         cbString        //字符串长度
 ) ;

函数调用示例：

 TextOut ( hdc, , , TEXT ("Hello World!"),  ) ;

第1个参数：表示显示字符串的控件ID；

第2个参数：表示字符串所在起始位置左上角（x,y）的x值为20；

第3个参数：表示字符串所在起始位置左上角（x,y）的y值为20；

第4个参数：表示字符串内容“Hello World!”；

第5个参数：表示字符串“Hello World!”长度为12；

wsprintf函数与TextOut函数的经典组合：

变量声明：

 int         iLength ;　　　　　　　　　　//字符串的长度
 TCHAR       szBuffer [] ;　　　　　//临时变量szBuffer,可以存储最大字符个数为1024

函数调用：

 iLength = wsprintf ( szBuffer,                      //将szBuffer指针指向字符串“The sum of %i and %i is %i”的地址
             TEXT ("The sum of %i and %i is %i"), iA, iB, iA + iB ) ;    //返回字符串长度为20 + (iA,iB,iA+iB)这3个数所占的字符长度
 TextOut = ( hdc, x, y, szBuffer, iLength ) ;        //在指定起始位置（x,y）输出字符串szBuffer

swprintf函数的参数介绍：

 int swprintf( 　　　　　　　　　　　//返回字符串的长度
     wchar_t *buffer,            //将buffer指针指向format指针指向的字符串
     const wchar_t *format       //格式化字符串输出
     [, argument] ...            //可选参数
 );

（二）TextOut函数实例应用

 #include <windows.h>

 /* 声明回调函数 */
 LRESULT CALLBACK WndProc ( HWND, UINT, WPARAM, LPARAM ) ;

 int WINAPI WinMain ( HINSTANCE hInstance, HINSTANCE hPrevInstance, PSTR szCmdLine, int iCmdShow )
 {
     static TCHAR    szAppName[] = TEXT ( "myTextOut" ) ;
     HWND            hwnd ;
     MSG             msg ;
     WNDCLASS        wndclass ;

     wndclass.style              = CS_HREDRAW | CS_VREDRAW ;                         //窗口样式
     wndclass.lpfnWndProc        = WndProc ;                                         //窗口的回调函数
     wndclass.hInstance          = hInstance ;                                       //窗口实例句柄
     wndclass.cbClsExtra         =  ;                                               //窗口结构体扩展：无
     wndclass.cbWndExtra         =  ;                                               //窗口实例扩展：无
     wndclass.hbrBackground      = ( HBRUSH ) GetStockObject ( WHITE_BRUSH ) ;       //窗口背景颜色：白色
     wndclass.hIcon              = LoadIcon ( NULL, IDI_APPLICATION ) ;              //窗口图标
     wndclass.hCursor            = LoadCursor ( NULL, IDC_ARROW ) ;                  //窗口中的鼠标样式
     wndclass.lpszClassName      = szAppName ;                                       //窗口结构体名称
     wndclass.lpszMenuName       = NULL ;                                            //主菜单名称：无

     if ( !RegisterClass ( &wndclass ) )
     {
         MessageBox ( NULL, TEXT ("无法注册窗口类！"), TEXT ("错误"), MB_OK | MB_ICONERROR ) ;
     }

     /* 创建窗口 */
     hwnd = CreateWindow (   szAppName, TEXT ("输出字符串演示"),
                             WS_OVERLAPPEDWINDOW,
                             CW_USEDEFAULT, CW_USEDEFAULT,
                             CW_USEDEFAULT, CW_USEDEFAULT,
                             NULL, NULL, hInstance, NULL ) ;

     /* 显示与更新窗口 */
     ShowWindow ( hwnd, iCmdShow ) ;
     UpdateWindow (hwnd) ;

     /* 从消息队列中获取消息 */
     while ( GetMessage ( &msg, NULL, ,  ) )
     {
         TranslateMessage ( &msg ) ;         //将虚拟键消息转换为字符消息
         DispatchMessage ( &msg ) ;          //分发到回调函数
     }

     return msg.wParam ;
 }

 /* 回调函数 */
 LRESULT CALLBACK WndProc ( HWND hwnd, UINT umsg, WPARAM wParam, LPARAM lParam )
 {
     static HDC      hdc ;
     PAINTSTRUCT     ps ;
     RECT            rect ;

     TCHAR           szText [] = TEXT ("Hello World!") ;
     static int      cxChar, cyChar ;

     switch ( umsg )
     {
     case WM_CREATE :        //处理窗口创建成功后发来的消息
         cxChar = LOWORD (GetDialogBaseUnits ());    //获得窗口中内定字体字元宽度（低字组）
         cyChar = HIWORD (GetDialogBaseUnits ());    //或得窗口中内定字体字元高度（高字组）
         return  ;

     case WM_PAINT:          //处理窗口产生无效区域时发来的消息
         hdc = BeginPaint ( hwnd, &ps ) ;

         GetClientRect ( hwnd, &rect ) ;     //获取窗口的矩形区域
         TextOut (   hdc,
                     rect.right /  - cxChar * lstrlen ( szText ) / ,       //使字符串在窗口中水平居中
                     ( rect.bottom - cyChar ) / ,                           //使字符串在窗口中垂直居中
                     szText,                     //字符串的内容
                     lstrlen ( szText )          //lstrlen函数获取字符串的长度
         ) ;
         EndPaint ( hwnd, &ps ) ;
         return  ;

     case WM_DESTROY:        //处理窗口关闭时发来的消息
         PostQuitMessage () ;
         return  ;
     }

     return DefWindowProc ( hwnd, umsg, wParam, lParam ) ;
 }

运行结果：

代码说明：

（1）程序主要包含WinMain主函数与WndProc回调函数；

 /* 主函数 */
 int WINAPI WinMain ( HINSTANCE hInstance, HINSTANCE hPrevInstance, PSTR szCmdLine, int iCmdShow )

 /* 回调函数 */
 LRESULT CALLBACK WndProc ( HWND hwnd, UINT umsg, WPARAM wParam, LPARAM lParam )

（2）在WinMain主函数中，主要实现窗口结构体的声明与属性赋值，窗口结构体注册，以及窗口的创建、显示和消息获取；

<1>窗口结构体的声明、属性赋值与注册

 WNDCLASS        wndclass ;          //声明窗口结构体

 wndclass.style              = CS_HREDRAW | CS_VREDRAW ;                         //窗口样式
 wndclass.lpfnWndProc        = WndProc ;                                         //窗口的回调函数
 wndclass.hInstance          = hInstance ;                                       //窗口实例句柄
 wndclass.cbClsExtra         =  ;                                               //窗口结构体扩展：无
 wndclass.cbWndExtra         =  ;                                               //窗口实例扩展：无
 wndclass.hbrBackground      = ( HBRUSH ) GetStockObject ( WHITE_BRUSH ) ;       //窗口背景颜色：白色
 wndclass.hIcon              = LoadIcon ( NULL, IDI_APPLICATION ) ;              //窗口图标
 wndclass.hCursor            = LoadCursor ( NULL, IDC_ARROW ) ;                  //窗口中的鼠标样式
 wndclass.lpszClassName      = szAppName ;                                       //窗口结构体名称
 wndclass.lpszMenuName       = NULL ;                                            //主菜单名称：无
 /* 注册窗口结构体 */
 if ( !RegisterClass ( &wndclass ) )
 {
     MessageBox ( NULL, TEXT ("无法注册窗口类！"), TEXT ("错误"), MB_OK | MB_ICONERROR ) ;
 }

<2>窗口创建与显示

 /* 创建窗口 */
 hwnd = CreateWindow (   szAppName, TEXT ("输出字符串演示"),
                         WS_OVERLAPPEDWINDOW,
                         CW_USEDEFAULT, CW_USEDEFAULT,
                         CW_USEDEFAULT, CW_USEDEFAULT,
                         NULL, NULL, hInstance, NULL ) ;

 /* 显示与更新窗口 */
 ShowWindow ( hwnd, iCmdShow ) ;
 UpdateWindow (hwnd) ;

<3>消息获取

 /* 从消息队列中获取消息 */
 while ( GetMessage ( &msg, NULL, ,  ) )
 {
     TranslateMessage ( &msg ) ;         //将虚拟键消息转换为字符消息
     DispatchMessage ( &msg ) ;          //分发到回调函数
 }

（3）在WndProc回调函数中，主要对Windows发来的消息进行处理，获取字体的宽度与高度，设置字符串显示的位置，显示字符串。

<1>获取字体的宽度与高度

 cxChar = LOWORD (GetDialogBaseUnits ());    //获得窗口中内定字体字元宽度（低字组）
 cyChar = HIWORD (GetDialogBaseUnits ());    //或得窗口中内定字体字元高度（高字组）

<2>设置字符串显示的位置并显示字符串

 hdc = BeginPaint ( hwnd, &ps ) ;

 GetClientRect ( hwnd, &rect ) ;     //获取窗口的矩形区域
 TextOut (   hdc,
             rect.right /  - cxChar * lstrlen ( szText ) / ,       //使字符串在窗口中水平居中
             ( rect.bottom - cyChar ) / ,                           //使字符串在窗口中垂直居中
             szText,                     //字符串的内容
             lstrlen ( szText )          //lstrlen函数获取字符串的长度
 ) ;
 EndPaint ( hwnd, &ps ) ;