GTK Gossip: GtkFrame 與 GtkAspectFrame

GtkFrame是GtkContainer的子類，可以容納子元件，並擁有一個外框及標籤文字：

GtkContainer
 +----GtkBin
       +----GtkFrame

您可以使用gtk_frame_new()建立一個GtkFrame，並在建立時指定標籤文字，或是在之後使用gtk_frame_set_label ()設定文字，標籤文字的位置預設是左上邊，您可以使用gtk_frame_set_label_align()設定標籤文字的位置：

GtkWidget* gtk_frame_new(const gchar *label);

void gtk_frame_set_label(GtkFrame *frame,
                         const gchar *label);

void gtk_frame_set_label_align(GtkFrame *frame,
                                gfloat xalign,
                               gfloat yalign);

gtk_frame_set_label_align()可以設定xalign與yalign，設定值為0.0到1.0，xalign設定水平對齊，yalign設定文字的垂直對齊，您也可以使用gtk_frame_set_shadow_type()來設定外框樣式：

void gtk_frame_set_shadow_type(GtkFrame      *frame,
                               GtkShadowType  type);

下面的程式是個簡單的設定範例：

• gtk_frame_demo.c

#include <gtk/gtk.h>



int main(int argc, char *argv[]) {

    GtkWidget *window;

    GtkWidget *frame;




    gtk_init(&argc, &argv);



    window = gtk_window_new(GTK_WINDOW_TOPLEVEL);

    gtk_window_set_title(GTK_WINDOW(window), "GtkFrame");

    gtk_window_set_default_size(GTK_WINDOW(window), 200, 150);



    frame = gtk_frame_new("caterpillar");


    gtk_frame_set_label_align(GTK_FRAME(frame), 0.5, 0.5);


    gtk_frame_set_shadow_type(GTK_FRAME(frame), GTK_SHADOW_ETCHED_OUT);




    gtk_container_add(GTK_CONTAINER(window), frame);




    g_signal_connect(GTK_OBJECT(window), "destroy",

                     G_CALLBACK(gtk_main_quit), NULL);



    gtk_widget_show_all(window);



    gtk_main();



    return 0;

}

下圖是一個執行的結果畫面：



GtkAspectFrame是GtkFrame的子類，使用上與GtkFrame類似，但多了xsize/ysize的比例設定，可用以限定子元件的長寬比例：

GtkWidget* gtk_aspect_frame_new(const gchar *label,
                                gfloat xalign,
                                gfloat yalign,
                                gfloat ratio,
                                gboolean obey_child);

xalign與yalign的作用與GtkFrame相同，ratio就是比例設定，obey_child設定為TRUE時，表示依子元件的長寬比例來顯示，若設定為FALSE，則表示依ratio的比例設定來顯示。

下面的範例是個簡單的示範，由於GtkAspectFrame的ratio設定為2（xsize/ysize），所以按鈕元件的顯示將依這個比例：

• gtk_aspect_frame_demo.c

#include <gtk/gtk.h>



int main(int argc, char *argv[]) {

    GtkWidget *window;

    GtkWidget *frame;


    GtkWidget *button;



    gtk_init(&argc, &argv);



    window = gtk_window_new(GTK_WINDOW_TOPLEVEL);

    gtk_window_set_title(GTK_WINDOW(window), "GtkAspectFrame");

    gtk_window_set_default_size(GTK_WINDOW(window), 300, 300);



    frame = gtk_aspect_frame_new("caterpillar", 0.5, 0.5, 2, FALSE);


    gtk_frame_set_shadow_type(GTK_FRAME(frame), GTK_SHADOW_ETCHED_OUT);




    button = gtk_button_new_with_label("Press");


    gtk_container_add(GTK_CONTAINER(frame), button);


    gtk_container_add(GTK_CONTAINER(window), frame);




    g_signal_connect(GTK_OBJECT(window), "destroy",

                     G_CALLBACK(gtk_main_quit), NULL);



    gtk_widget_show_all(window);



    gtk_main();



    return 0;

}

一個執行的結果如下所示：