2025年4月1日 星期二 乙巳(蛇)年 正月初二 设为首页 加入收藏
rss
您当前的位置:首页 > 计算机 > 编程开发 > VC/VC++

Windows static控件(静态文本框控件)

时间:12-28来源:作者:点击数:256

使用 TextOut 和 DrawText 函数有时候会不方便,例如:

  • 文本不能自动换行,超出窗口范围会被隐藏;
  • 每次更改文本都要先擦除背景再重新输出,比较麻烦。

实际开发中一般使用静态文本框控件来输出文本。静态文本框是Windows 的一种标准控件,可以用来在窗口上显示一段文本,并且文本容易受到控制。除了静态文本框,Windows的标准控件还有很多种,例如按钮、下拉菜单、单选按钮、复选框等。

其实,控件也是一种窗口,也使用 CreateWindow 函数来创建。但是它们使用的窗口类的名字比较特殊,是由Windows预定义的;静态文本框控件的窗口类名是static

与前面创建的独立窗口不同,控件是子窗口,创建时必须指定父窗口,这样控件才能有“归属”。

我们先来回顾一下 CreateWindow 函数的原型:

  • HWND CreateWindow(
  • LPCWSTR lpClassName, //窗口类名
  • LPCWSTR lpWindowName, //窗体标题(或控件文本)
  • DWORD dwStyle, //窗口/控件样式
  • int x, //窗口相对桌面(或子窗口相对父窗口)的 X 坐标
  • int y, //窗口相对桌面(或子窗口相对父窗口)的 Y 坐标
  • int nWidth, //窗体宽度
  • int nHeight, //窗体高度
  • HWND hWndParent, //父窗口句柄
  • HMENU hMenu, //菜单句柄
  • HINSTANCE hInstance, //当前程序实例句柄
  • LPVOID lpParam //一个指向某数值的指针
  • );

几点说明:

1) 对于参数 lpClassName 和 lpWindowName,一般使用宽字符,请加前缀L或使用TEXT()

lpClassName 为窗口类的名字,可以是 RegisterClass 注册的类名,也可以是 Windows 预定义的控件类名。

如果你创建的是独立窗口,则 lpWindowName 应传入窗口的标题,若你希望创建控件,则应传入控件的文本。

2) dwStyle 表示窗口样式或控件样式。窗口样式以 WS 开头,详情请查看《CreateWindow窗口风格取值》。这些样式既可以用于独立窗口,也可以用于控件(子窗口)。

除了窗口样式,不同的控件也有自己特有的样式。对于 static 控件,它的样式以 SS 开头,常用的有:

样式 说明
SS_LEFT 文本居左。
SS_RIGHT 文本居右。
SS_CENTER 文本居中。
SS_CENTERIMAGE 文本垂直居中。设置该样式后只能显示一行文本,即使有 '\n' 也不会换行。
SS_LEFTNOWORDWRAP 文本居左,不自动换行(有 '\n' 才会换行),超出控件范围的文本将被隐藏。
SS_SIMPLE 只显示一行文本(有 '\n' 也不换行),且不自动换行,超出控件范围的文本将被隐藏。

3) 对于参数 hWndParent,如果是独立窗口,那么为 NULL,如果是控件,那么就需要父窗口的句柄。

4) 参数 hMenu 十分重要,在后续介绍的需要处理控件消息的控件中,这是他们的唯一标识符。每个控件的 hMenu 参数值都应不同,并且需要强制转换到 HMENU 类型,如 (HMENU)1 ,再次强调,每个控件的(HMENU)后的值都应不同,可以从1往下递推。

下面的代码,会在 WM_CREATE 事件中创建 static 控件:

  • //窗口过程
  • LRESULT CALLBACK WndProc(
  • HWND hWnd,
  • UINT message,
  • WPARAM wParam,
  • LPARAM lParam
  • ){
  • PAINTSTRUCT ps;
  • HDC hdc;
  • HWND hStatic;
  • switch (message){
  • case WM_CREATE:
  • hStatic = CreateWindow(
  • L"static", //静态文本框的类名
  • L"城东书院", //控件的文本
  • WS_CHILD /*子窗口*/ | WS_VISIBLE /*创建时显示*/ | WS_BORDER /*带边框*/| SS_CENTER /*水平居中*/ | SS_CENTERIMAGE /*垂直居中*/,
  • 20 /*X坐标*/, 20 /*Y坐标*/, 200 /*宽度*/, 100 /*高度*/,
  • hWnd, //父窗口句柄
  • (HMENU)1, //为控件指定一个唯一标识符
  • hInst, //当前程序实例句柄
  • NULL
  • );
  • break;
  • case WM_PAINT:
  • hdc = BeginPaint(hWnd, &ps);
  • // TODO: 在此添加任意绘图代码...
  • EndPaint(hWnd, &ps);
  • break;
  • case WM_DESTROY:
  • PostQuitMessage(0);
  • break;
  • }
  • return DefWindowProc(hWnd, message, wParam, lParam) ;
  • }

运行效果:

完整代码下载:

static_demo.rar
ec4da581e5a8cebdac3293a5215d1062.rar (1.45 KB)

给 CreateWindow 函数传入的第三个参数为窗口样式或控件样式(子窗口样式)。不同的控件样式一般不同,而窗口样式则大同小异:

  • WS_CHILD:表明是一个子窗口,也就是控件,不是独立窗口。
  • WS_VISIBLE:创建时显示,如果没有该样式,则需要调用 ShowWindow 函数来显示。
  • WS_BORDER:带边框。

给 CreateWindow 函数传入的倒数第二个参数为 hInst,表示当前程序的实例句柄。hInst 在 WndProc 函数中并不存在,因为当前实例句柄是通过 WinMain 函数的参数传入的,所以必须要定义一个全局变量 hInst,然后在 WinMain 中给它赋值后才能使用。如下所示:

  • #include <windows.h>
  • HINSTANCE hInst;
  • int WINAPI WinMain(
  • HINSTANCE hInstance,
  • HINSTANCE hPrevInstance,
  • PSTR szCmdLine,
  • int iCmdShow
  • ){
  • // TODO: 其他代码
  • hInst = hInstance;
  • // TODO: 其他代码
  • }

另外,你也可以通过((LPCREATESTRUCT)lParam)->hInstance语句获得当前程序实例句柄,有兴趣的朋友请自行Google或百度。

获取、修改控件文本

GetWindowText 函数用于将指定窗口的标题文本(如果存在)拷贝到一个缓存区内;如果指定的窗口是一个控件,则拷贝控件的文本。它的原型为:

  • Int GetWindowText(
  • HWND hWnd, //窗口/控件句柄
  • LPTSTR lpString, //指向接收文本的缓冲区指针
  • Int nMaxCount //要保存在缓冲区内的字符的最大个数
  • );

说明:

  • nMaxCount 指定要保存在缓冲区内的字符的最大个数,其中包含NULL字符。如果文本超过界限,它就被截断。
  • 函数执行成功,返回拷贝的字符的个数。

代码举例:

  • //定义缓冲区
  • TCHAR szStaticBuf[100];
  • //获取 static 控件的文本
  • GetWindowText(hStatic, szStaticBuf, 100);

类似的,SetWindowText 函数可以用来设置窗口标题或控件文本,它的原型为:

  • BOOL SetWindowText(
  • HWND hwnd,
  • LPCTSTR lpString
  • );

下面的例子用来显示鼠标点击的次数:

  • //窗口过程
  • LRESULT CALLBACK WndProc(
  • HWND hWnd,
  • UINT message,
  • WPARAM wParam,
  • LPARAM lParam
  • ){
  • PAINTSTRUCT ps;
  • HDC hdc;
  • //必须被设置为静态变量
  • static int iClick = 0; //鼠标单击次数
  • static TCHAR szTextBuf[20]; //static 控件文本(缓冲区)
  • static HWND hStatic; //static 控件句柄
  • switch (message){
  • case WM_CREATE:
  • hStatic = CreateWindow(
  • L"static", //静态文本框的类名
  • L"城东书院", //控件的文本
  • WS_CHILD /*子窗口*/ | WS_VISIBLE /*创建时显示*/ | WS_BORDER /*带边框*/| SS_CENTER /*水平居中*/ | SS_CENTERIMAGE /*垂直居中*/,
  • 20 /*X坐标*/, 20 /*Y坐标*/, 200 /*宽度*/, 100 /*高度*/,
  • hWnd, //父窗口句柄
  • (HMENU)1, //为控件指定一个唯一标识符
  • hInst, //当前程序实例句柄
  • NULL
  • );
  • break;
  • case WM_PAINT:
  • hdc = BeginPaint(hWnd, &ps);
  • // TODO: 在此添加任意绘图代码...
  • EndPaint(hWnd, &ps);
  • break;
  • case WM_LBUTTONDOWN: //鼠标左键单击消息
  • iClick++;
  • wsprintf(szTextBuf, TEXT("鼠标被单击%d次"), iClick);
  • SetWindowText(hStatic, szTextBuf);
  • break;
  • case WM_DESTROY:
  • PostQuitMessage(0);
  • break;
  • }
  • return DefWindowProc(hWnd, message, wParam, lParam) ;
  • }

运行程序后,在客户区单击鼠标查看效果。下面是一张截图

完整代码下载:

set_static_text.rar
b082e31c24589c9ead1bd8afa439a401.rar (1.58 KB)

几点说明:

1) WM_LBUTTONDOWN 为鼠标左键单击消息。

2) wsprintf 与C语言中的 printf 类似,都是格式化输出函数,不过 wsprintf 一般将字符串输出到缓冲区,而 printf 输出到控制台。它的原型为:

  • int wsprintf(
  • LPTSTR lpBuffer, //接收字符串的缓冲区的指针
  • LPCTSTR lpFormat, //格式控制字符串
  • [paramList] //参数列表
  • );

3) 声明 static 变量的目的是使局部变量持久化。第一次执行窗口函数会产生 WM_CREATE 消息,初始化 hStatic 变量。如果不声明为 static,那么当函数执行结束后 hStatic 变量就会被销毁,接下来单击鼠标执行窗口函数时,再也不会产生 WM_CREATE 消息,也就意味着 hStatic 变量不会被赋值,将无法使用。

对于窗口函数中的变量,如果是在 WM_CREATE 消息中赋值,但在其他消息中使用,那么一般声明为静态变量,这样下次执行窗口函数时依然有效。

更多关于 static 变量的内容请查看:C语言static变量和函数

4) 我们将在《修改static控件背景颜色和文字颜色》一节中讲解 static 控件背景颜色和文字颜色的修改。

方便获取更多学习、工作、生活信息请关注本站微信公众号城东书院 微信服务号城东书院 微信订阅号
推荐内容
相关内容
栏目更新
栏目热门