GTK+ 2.0 教学-标尺 Rulers

标尺元件(Ruler widgets)一般用于在给定视窗中指示滑鼠指标的位置。一个视窗可以有一个横跨整个视窗宽度的水平标尺和一个占据整个视窗高度的垂直标尺。标尺上有一个小三角形的指示器标出滑鼠指标相对于标尺的精确位置。

[adsense][/adsense]

首先,必须创建标尺。水平和垂直标尺用下面的函式创建:

GtkWidget *gtk_hruler_new( void );    /* 水平标尺 */

GtkWidget *gtk_vruler_new( void );    /* 垂直标尺 */

一旦创建了标尺,我们就能指定它的度量单位。标尺的度量单位可以是 GTK_PIXELSGTK_INCHESGTK_CENTIMETERS。可以用下面的函式设置:

void gtk_ruler_set_metric( GtkRuler      *ruler,
                           GtkMetricType  metric );

预设的度量单位是GTK_PIXELS

gtk_ruler_set_metric( GTK_RULER(ruler), GTK_PIXELS );

标尺元件的另一个重要属性是怎样标示刻度单位以及位置指示器一开始应该放在哪里。可以用下面的函式设置:

void gtk_ruler_set_range( GtkRuler *ruler,
                          gdouble   lower,
                          gdouble   upper,
                          gdouble   position,
                          gdouble   max_size );

其中lower和upper参数定义标尺的范围,max_size是要显示的最大可能数值。Position定义了标尺的指标指示器的初始位置。

下面这句使垂直标尺能跨越800像素宽的视窗。

gtk_ruler_set_range( GTK_RULER(vruler), 0, 800, 0, 800);

标尺上显示标示会从0到800,每100个像素一个数字。如果我们想让标尺的范围为从7到16,可以使用下面的程式码:

gtk_ruler_set_range( GTK_RULER(vruler), 7, 16, 0, 20);

标尺上的指示器是一个小三角形的标记,指示滑鼠指标相对于标尺的位置。如果标尺是用于跟踪滑鼠指标的,应该将motion_notify_event信号连接到标尺的motion_notify_event方法(method)。要跟踪滑鼠在整个视窗区域里的移动,应该这样做:

#define EVENT_METHOD(i, x) GTK_WIDGET_GET_CLASS(i)->x

    g_signal_connect_swapped (area, "motion_notify_event",
           G_CALLBACK (EVENT_METHOD (ruler, motion_notify_event)),
           ruler);

下列范例创建一个绘图区(drawing area),上面加一个水平标尺,左边加一个垂直标尺。绘图区的大小是600像素宽×400像素高。水平标尺范围是从7到13,每100像素加一个刻度; 垂直标尺范围从0到400,每100像素加一个刻度。绘图区和标尺的定位是用一个封装表格(table)实现的。

#include <gtk/gtk.h>

#define EVENT_METHOD(i, x) GTK_WIDGET_GET_CLASS(i)->x

#define XSIZE  600
#define YSIZE  400

/* 当点击"close"按钮时,退出应用程式 */
static gboolean close_application( GtkWidget *widget,
                                   GdkEvent  *event,
                                   gpointer   data )
{
    gtk_main_quit ();
    return FALSE;
}
/* 主函式 */
int main( int   argc,
          char *argv[] ) {
    GtkWidget *window, *table, *area, *hrule, *vrule;
/* 初始化,创建主视窗 */
    gtk_init (&argc, &argv);

    window = gtk_window_new (GTK_WINDOW_TOPLEVEL);
    g_signal_connect (window, "delete-event",
                      G_CALLBACK (close_application), NULL);
    gtk_container_set_border_width (GTK_CONTAINER (window), 10);
/* 创建一个封装表格,绘图区和标尺放在里面 */
    table = gtk_table_new (3, 2, FALSE);
    gtk_container_add (GTK_CONTAINER (window), table);

    area = gtk_drawing_area_new ();
    gtk_widget_set_size_request (GTK_WIDGET (area), XSIZE, YSIZE);
    gtk_table_attach (GTK_TABLE (table), area, 1, 2, 1, 2,
                      GTK_EXPAND|GTK_FILL, GTK_FILL, 0, 0);
    gtk_widget_set_events (area, GDK_POINTER_MOTION_MASK |
                                 GDK_POINTER_MOTION_HINT_MASK);
/* 水平标尺放在顶部。滑鼠移动穿过绘图区时,一个
     * motion_notify_event 被传递给标尺的相应的事件处理函式 */
    hrule = gtk_hruler_new ();
    gtk_ruler_set_metric (GTK_RULER (hrule), GTK_PIXELS);
    gtk_ruler_set_range (GTK_RULER (hrule), 7, 13, 0, 20);
    g_signal_connect_swapped (area, "motion_notify_event",
                              G_CALLBACK (EVENT_METHOD (hrule, motion_notify_event)),
                              hrule);
    gtk_table_attach (GTK_TABLE (table), hrule, 1, 2, 0, 1,
                      GTK_EXPAND|GTK_SHRINK|GTK_FILL, GTK_FILL, 0, 0);
/* 垂直标尺放在左边。当滑鼠移动穿过绘图区时,一个
     * motion_notify_event 被传递到标尺相应的事件处理函式中 */
    vrule = gtk_vruler_new ();
    gtk_ruler_set_metric (GTK_RULER (vrule), GTK_PIXELS);
    gtk_ruler_set_range (GTK_RULER (vrule), 0, YSIZE, 10, YSIZE );
    g_signal_connect_swapped (area, "motion_notify_event",
                              G_CALLBACK (EVENT_METHOD (vrule, motion_notify_event)),
                              vrule);
    gtk_table_attach (GTK_TABLE (table), vrule, 0, 1, 1, 2,
                      GTK_FILL, GTK_EXPAND|GTK_SHRINK|GTK_FILL, 0, 0);
    /* 现在显示所有的元件 */
    gtk_widget_show (area);
    gtk_widget_show (hrule);
    gtk_widget_show (vrule);
    gtk_widget_show (table);
    gtk_widget_show (window);
    gtk_main ();

    return 0;
}

Comments are closed.