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的說明。

From Gossip@caterpillar

GTK Gossip: GtkTable