GTK+ 2.0 教学-框架 Frames

By:
On:
In: LinuxDev
Tagged:

框架(Frames)可以用于在盒子中封装一个或一组元件，框架本身还可以有一个标签。标签的位置和盒子的风格可以灵活改变。

[adsense][/adsense]

框架可以用下面的函式创建：

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 );

xalign和yalign参数取值范围介于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;
}

Comments are closed.