GTK Gossip: GtkTable

在進行元件排版的時候，將元件以類似表格的方式排放也是很常見的排版方式，在GTK中，您可以使用GtkTable，您可以使用gtk_table_new()函式來建立：

GtkWidget *table = gtk_table_new(3, 3, TRUE);

上面的程式碼片段也建立3列（row）、3行（column）的表格，第三個參數則設定表格中的空間是否平均分配，所以若設定為TRUE，每一格的空間將取決於置於其中最大的元件。

要將元件置於表格之中，可以使用gtk_table_attach()函式：

void gtk_table_attach( GtkTable         *table,
                      GtkWidget        *child,
                      guint           left_attach,
                      guint           right_attach,
                      guint           top_attach,
                      guint           bottom_attach,
                      GtkAttachOptions xoptions,
                      GtkAttachOptions yoptions,
                      guint           xpadding,
                      guint           ypadding );

這個函式中的left_attach、right_attach、top_attach、bottom_attach，決定了元件將佔據的空間，例如若是3X3表格：

 0         1          2         3
0+----------+----------+----------+
 |          |          |          |
1+----------+----------+----------+
 |          |          |          |
2+----------+----------+----------+
 |          |          |          |
3+----------+----------+----------+

若要讓元件佔據左上格空間，則left_attach為0、right_attach為1、top_attach為0、bottom_attach為1，若要讓元件佔據右下格空間，則left_attach為1、right_attach為2、top_attach為1、bottom_attach為2，若要讓元件佔據底下兩格空間，則left_attach為0、right_attach為2、top_attach為1、bottom_attach為2，依此類推。

xoptions與yoptions為元件佔據空間的方式，可以指定以下的值，可以使用OR結合值：

• GTK_FILL：若元件原本小於可用空間，則元件會填滿可用空間。
• GTK_SHRINK：若元件原本大於可用空間，則元件會縮小以符合可用空間。
• GTK_EXPAND：表格會擴展以符合元件大小。

您可以使用gtk_table_attach_defaults()函式，預設選項為GTK_FILL | GTK_EXPAND，padding都設為0：

void gtk_table_attach_defaults( GtkTable  *table,
                               GtkWidget *widget,
                               guint      left_attach,
                               guint      right_attach,
                               guint      top_attach,
                               guint      bottom_attach );

下面的程式先示範簡單的GtkTable使用方式：

• gtk_table_demo.c

#include <gtk/gtk.h>

int main(int argc, char *argv[]) {
GtkWidget *window;
GtkWidget *table;
GtkWidget *label;

const char *text[] = {"One", "Two", "Three",
"Four", "Five", "Six",
"Seven", "Eight", "Nine"};
int i, j, k;

gtk_init(&argc, &argv);

window = gtk_window_new(GTK_WINDOW_TOPLEVEL);
gtk_window_set_title(GTK_WINDOW(window), "GtkTable");
gtk_window_set_default_size(GTK_WINDOW(window), 250, 150);

table = gtk_table_new(3, 3, TRUE);
for(i = 0, k = 0; i < 3; i++, k = k + 3) {
for(j = 0; j < 3; j++) {
label = gtk_label_new(text[k + j]);
gtk_table_attach_defaults(
GTK_TABLE(table), label, j, j + 1, i, i + 1);
}
}

gtk_container_add(GTK_CONTAINER(window), table);

g_signal_connect(GTK_OBJECT(window), "destroy",
G_CALLBACK(gtk_main_quit), NULL);

gtk_widget_show_all(window);

gtk_main();

return 0;
}
程式執行時的參考畫面如下：



GtkTable的left_attach、right_attach、top_attach、bottom_attach指定方式，可以讓您方便的達到元件跨數格的方式，在Table Packing Example中有個例子，您也可以再參考 Packing Using Tables 中有關GtkTable的說明。