GTK+ 2.0 教學-框架 Frames

框架(Frames)可以用於在盒子中封裝一個或一組元件,框架本身還可以有一個標籤。標籤的位置和盒子的風格可以靈活改變。

框架可以用下面的函式創建:

GtkWidget *gtk_frame_new( const gchar *label );

標籤預設放在框架的左上角。傳遞NULL值作為label參數時,框架不顯示標籤。標籤文字可以用下面的函式改變。

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

標籤的位置可以用下面的函式改變:

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

xalignyalign參數取值範圍介於0.0和1.0之間。xalign指定標籤在框架元件上部水平線上的位置。yalign目前還沒有被使用。xalign的預設值是0.0,它將標籤放在框架元件的最左端。

下面的函式改變盒子的風格,用於顯示框架的輪廓。

void gtk_frame_set_shadow_type( GtkFrame      *frame,
                                GtkShadowType  type);

type參數可以取以下值之一:

  GTK_SHADOW_NONE
  GTK_SHADOW_IN
  GTK_SHADOW_OUT
  GTK_SHADOW_ETCHED_IN (預設值)
  GTK_SHADOW_ETCHED_OUT

下面的範例說明了怎樣使用框架元件。

#include <gtk/gtk.h>

int main( int   argc,
          char *argv[] )
{
  /* GtkWidget 是元件的存儲類型 */
  GtkWidget *window;
  GtkWidget *frame;

  /* 初始化 */
  gtk_init (&argc, &argv);

  /* 創建一個新視窗 */
  window = gtk_window_new (GTK_WINDOW_TOPLEVEL);
  gtk_window_set_title (GTK_WINDOW (window), "Frame Example");

  /* 在這裡我們將 "destroy" 事件連接到一個回呼函式 */ 
  g_signal_connect (G_OBJECT (window), "destroy",
		    G_CALLBACK (gtk_main_quit), NULL);

  gtk_widget_set_size_request (window, 300, 300);
  /* 設置視窗的邊框寬度 */
  gtk_container_set_border_width (GTK_CONTAINER (window), 10);

  /* 創建一個框架 */
  frame = gtk_frame_new (NULL);
  gtk_container_add (GTK_CONTAINER (window), frame);

  /* 設置框架的標籤 */
  gtk_frame_set_label (GTK_FRAME (frame), "GTK Frame Widget");

  /* 將標籤定位在框架的右邊 */
  gtk_frame_set_label_align (GTK_FRAME (frame), 1.0, 0.0);

  /* 設置框架的風格 */
  gtk_frame_set_shadow_type (GTK_FRAME (frame), GTK_SHADOW_ETCHED_OUT);

  gtk_widget_show (frame);

  /* 顯示視窗 */
  gtk_widget_show (window);

  /* 進入事件循環 */
  gtk_main ();

  return 0;
}

感謝你看到這裡,很快就可以離開了,但最好的獎勵行動就是按一下幫我分享或留言,感恩喔~

點我分享到Facebook

發佈留言

發佈留言必須填寫的電子郵件地址不會公開。 必填欄位標示為 *