GTK+ 2.0 教學-標尺 Rulers

標尺元件(Ruler widgets)一般用於在給定視窗中指示滑鼠指標的位置。一個視窗可以有一個橫跨整個視窗寬度的水平標尺和一個佔據整個視窗高度的垂直標尺。標尺上有一個小三角形的指示器標出滑鼠指標相對於標尺的精確位置。

首先,必須創建標尺。水平和垂直標尺用下面的函式創建:

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

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

點我分享到Facebook

發佈留言

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