当前位置：首页 > news >正文

GTK4 常用控件入门

news 2026/5/11 17:33:46

0 前言

在《GTK4开发环境搭建》中，我们成功运行了第一个 GTK4 窗口程序，认识了 GtkApplication、GtkApplicationWindow 和 GtkLabel 三个基础组件。本文将在此基础上系统学习 GTK4 的常用控件。

GTK4 提供了丰富的控件库（GtkWidget），从简单的标签、按钮到复杂的树视图、文本编辑器。掌握这些控件是构建图形界面的基础。

本文目标：

掌握常用基础控件的使用（Label、Button、Entry、Image、ProgressBar）
理解容器的布局管理（GtkBox）
学会信号与回调机制的实际应用
每个控件都提供独立可运行的完整代码

阅读前提：

已完成 GTK4 开发环境搭建
了解 C 语言基础语法
理解 GObject 对象系统和信号机制（参见《GTK开发从入门到实践：开篇导读》第2章）

1 控件基础概念

1.1 GtkWidget 层次结构

GTK4 中所有控件都继承自 GtkWidget 基类，形成了清晰的继承体系。了解继承关系有助于理解控件的共有属性。

常用控件继承关系：

图1.1 常用控件继承关系

继承的实际意义：

所有控件都可用gtk_widget_set_visible()控制显示/隐藏
所有控件都可用gtk_widget_set_halign()设置水平对齐方式
所有控件都可通过g_signal_connect()连接信号

1.2 控件的共有属性和方法

在深入学习具体控件前，先掌握所有控件共有的基础操作：

显示/隐藏控件：

// 显示控件gtk_widget_set_visible(widget,TRUE);// 隐藏控件gtk_widget_set_visible(widget,FALSE);// 或使用 show/hide 便捷函数gtk_widget_show(widget);gtk_widget_hide(widget);// @file: examples/common_api_show_hide.c

尺寸设置：

// 设置请求的宽度（高度自适应内容）gtk_widget_set_size_request(widget,200,-1);// 设置最小尺寸（实际尺寸由布局容器决定）gtk_widget_set_size_request(widget,200,100);// @file: examples/common_api_size.c

对齐方式：

// 水平对齐：START（左）、CENTER（中）、END（右）gtk_widget_set_halign(widget,GTK_ALIGN_START);// 垂直对齐：START（上）、CENTER（中）、END（下）gtk_widget_set_valign(widget,GTK_ALIGN_CENTER);// @file: examples/common_api_align.c

边距设置：

// 设置四个方向的外边距gtk_widget_set_margin_top(widget,10);gtk_widget_set_margin_bottom(widget,10);gtk_widget_set_margin_start(widget,10);gtk_widget_set_margin_end(widget,10);// 或使用统一的边距gtk_widget_set_margin_start(widget,10);gtk_widget_set_margin_end(widget,10);gtk_widget_set_margin_top(widget,10);gtk_widget_set_margin_bottom(widget,10);// @file: examples/common_api_margin.c

2 常用控件详解

2.1 GtkLabel：标签控件

GtkLabel 是 GTK 中最简单的控件，用于显示只读文本。它在界面中起到说明、提示、标题等作用。

主要功能：

显示单行或多行文本
支持简单的 HTML 标记（<b>加粗</b>、<i>斜体</i>）
文本选择与复制（默认禁用）

常用 API：

// 创建标签GtkWidget*gtk_label_new(constgchar*text);// 设置文本内容voidgtk_label_set_text(GtkLabel*label,constgchar*text);// 获取当前文本constgchar*gtk_label_get_text(GtkLabel*label);// 设置标记文本（支持 HTML）voidgtk_label_set_markup(GtkLabel*label,constgchar*str);// @file: examples/label_api.c

完整示例：文本操作与选择：

创建label_demo.c：

#include<gtk/gtk.h>staticvoidon_toggle_selectable(GtkButton*button,GtkLabel*label){gboolean selectable=gtk_label_get_selectable(label);gtk_label_set_selectable(label,!selectable