一、GtkBox及C语言示例

GtkBox是一个容器部件，用于在GTK（GIMP Toolkit）应用程序中水平或垂直地排列多个子部件。以下是一个简单的例子，展示了如何在一个基本的GTK应用程序中使用`GtkBox`来垂直排列两个按钮：
首先，确保你安装了GTK（对于GTK 3或GTK 4，视你所使用的版本而定）。下面的例子将使用GTK 3。
在系统上创建一个名为`gtk_box_example.c`的新文件，并粘贴以下代码作为示例：

#include <gtk/gtk.h>static void on_activate(GtkApplication* app, gpointer user_data) {// 创建一个新的窗口GtkWidget *window = gtk_application_window_new(app);// 设置窗口标题、边框宽度和默认大小gtk_window_set_title(GTK_WINDOW(window), "GtkBox Example");gtk_container_set_border_width(GTK_CONTAINER(window), 10);gtk_window_set_default_size(GTK_WINDOW(window), 800, 600);// 创建一个垂直箱（GtkBox）GtkWidget *vbox = gtk_box_new(GTK_ORIENTATION_VERTICAL, 5);// 增加一个展开的盒子，使得按钮可以在底部对齐GtkWidget *expander = gtk_box_new(GTK_ORIENTATION_VERTICAL, 0);gtk_box_pack_start(GTK_BOX(vbox), expander, TRUE, TRUE, 0);// 创建两个按钮GtkWidget *button1 = gtk_button_new_with_label("Button 1");GtkWidget *button2 = gtk_button_new_with_label("Button 2");// 设置两个按钮的大小请求（为窗体的1/10以下）gtk_widget_set_size_request(button1, 80, 60);gtk_widget_set_size_request(button2, 80, 60);// 设置按钮的边缘空间（margin）gtk_widget_set_margin_end(button1, 20); // 右边距gtk_widget_set_margin_bottom(button1, 20); // 底边距gtk_widget_set_margin_end(button2, 20); // 右边距gtk_widget_set_margin_bottom(button2, 20); // 底边距// 设置按钮的水平和垂直对齐方式（左下角）gtk_widget_set_halign(button1, GTK_ALIGN_END);gtk_widget_set_valign(button1, GTK_ALIGN_END);gtk_widget_set_halign(button2, GTK_ALIGN_END);gtk_widget_set_valign(button2, GTK_ALIGN_END);// 不要让按钮填充箱子剩余的空间，设置expand为FALSEgtk_box_pack_end(GTK_BOX(vbox), button1, FALSE, FALSE, 0);gtk_box_pack_end(GTK_BOX(vbox), button2, FALSE, FALSE, 0);// 将垂直箱添加到窗口中gtk_container_add(GTK_CONTAINER(window), vbox);// 显示所有部件gtk_widget_show_all(window);
}int main(int argc, char *argv[]) {// 创建一个新的GtkApplicationGtkApplication *app = gtk_application_new("org.example.myapp", G_APPLICATION_FLAGS_NONE);g_signal_connect(app, "activate", G_CALLBACK(on_activate), NULL);// 运行应用程序，将命令行参数传给它int status = g_application_run(G_APPLICATION(app), argc, argv);// 清理g_object_unref(app);return status;
}

现在，编译这个程序。在终端中，使用以下命令（如果使用的是GTK 4，请替换所有`gtk+-3.0`为`gtk4`）：

gcc `pkg-config --cflags gtk+-3.0` -o gtk_box_example gtk_box_example.c `pkg-config --libs gtk+-3.0`

编译成功后，可以直接运行编译出的可执行文件：

./gtk_box_example

当运行这个程序时，应该看到一个窗口出现，窗口中有两个垂直排列的按钮。这段代码创建了一个`GtkApplication`，在激活时设置了一个窗口，并添加了一个`GtkBox`作为容器将两个按钮垂直排列。

`gtk_window_set_default_size()`来设置窗口大小，以及利用`gtk_widget_set_halign()`和`gtk_widget_set_valign()`来设置按钮在`GtkBox`中的对齐方式，并使用`gtk_widget_set_size_request()`来设置按钮的请求大小。

使用了一个分隔器部件（expander）来将按钮推到窗口的底部，并使用`gtk_widget_set_margin_*`函数设置按钮的边距来取消按钮和窗口边缘之间的贴合。在按钮和窗口的右侧以及底部分别设置了20像素的边距。`gtk_widget_set_margin_end`和`gtk_widget_set_margin_bottom`函数分别为按钮设置了右侧和底部的边距，这样按钮就不会直接贴在窗口的边缘上了。另外，使用了`GTK_ALIGN_END`来使按钮靠近窗口的右侧和底部。

创建一个空白的"占位"容器`expander`，它会填充大部分的垂直空间，将按钮定位在窗口的左下角。同时，也调整了两个按钮的大小请求，这样即使窗口再大，按钮的最大大小也不会超过80x60像素。填充部件`expander`添加到`vbox`的开始处。然后创建按钮，并使用`gtk_box_pack_end`加到vbox的末尾。`expander`部件将占据所有剩余的垂直空间，并推动按钮到窗口的底部。窗口大小应该是800x600像素，两个按钮将位于窗口的左下角，并且与窗口边界有一些空间。 

每次点击按钮，都会增加到箱子里，因为在这个例子中没有连接任何信号处理函数，所以按钮不会执行任何操作。
请注意，GTK 4中的某些函数和方法可能已经发生了更改，而且本例是基于GTK 3的。如果你使用的是GTK 4，请相应地调整API调用。

二、GtkBox的python示例

下面是将C语言 GTK 示例转换为Python版本，使用PyGObject绑定。这个例子假设已经安装了`PyGObject`和正确版本的GTK+库。
首先，确保安装了`PyGObject`。如果还没有安装，请参考PyGObject的文档了解如何安装。一旦完成安装，可以创建一个名为`gtk_box_example.py`的文件，并粘贴以下代码：

import gi
gi.require_version('Gtk', '3.0')
from gi.repository import Gtkclass MyApplication(Gtk.Application):def do_activate(self):# 创建一个新的窗口window = Gtk.ApplicationWindow(application=self)# 设置窗口标题、边框宽度和默认大小window.set_title("GtkBox Example")window.set_border_width(10)window.set_default_size(800, 600)# 创建一个垂直箱（GtkBox）vbox = Gtk.Box(orientation=Gtk.Orientation.VERTICAL, spacing=5)# 增加一个展开的盒子，使得按钮可以在底部对齐expander = Gtk.Box(orientation=Gtk.Orientation.VERTICAL)vbox.pack_start(expander, True, True, 0)# 创建两个按钮button1 = Gtk.Button(label="Button 1")button2 = Gtk.Button(label="Button 2")# 设置两个按钮的大小请求（为窗体的1/10以下）button1.set_size_request(80, 60)button2.set_size_request(80, 60)# 设置按钮的边缘空间（margin）button1.set_margin_end(20)button1.set_margin_bottom(20)button2.set_margin_end(20)button2.set_margin_bottom(20)# 设置按钮的水平和垂直对齐方式（右下角）button1.set_halign(Gtk.Align.END)button1.set_valign(Gtk.Align.END)button2.set_halign(Gtk.Align.END)button2.set_valign(Gtk.Align.END)# 将按钮放置在箱子的底部，不让它们展开或填充vbox.pack_end(button1, False, False, 0)vbox.pack_end(button2, False, False, 0)# 将垂直箱添加到窗口中window.add(vbox)# 显示所有部件window.show_all()if __name__ == "__main__":# 创建一个新的GtkApplicationapp = MyApplication()app.run(None)

确保已经安装了`python3-gi`和`python3-gi-cairo`包以及GTK 3。如果在Gtk.Application.run()中没有特定的命令行参数传递，可以简单地用`None`替代。
要运行这个Python脚本，只需在终端中运行以下命令：

python3 gtk_box_example.py

应该会看到一个包含两个按钮的窗口，这些按钮被放置在窗口的底部右侧，并且它们不会填满窗口的剩余空间。