标尺 Rulers

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

首先，必须创建标尺。水平和垂直标尺用下面的函数创建：

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

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

一旦创建了标尺，我们就能指定它的度量单位。标尺的度量单位可以是 GTK_PIXELS，GTK_INCHES或GTK_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 (G_OBJECT (area), "motion_notify_event",
           G_CALLBACK (EVENT_METHOD (ruler, motion_notify_event)),
           G_OBJECT (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"按钮时，退出应用程序 */
gint 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 (G_OBJECT (window), "delete_event",
                          G_CALLBACK (close_application), NULL);
    gtk_window_set_title (GTK_WINDOW (window), "www.softool.cn - ruler");
    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 (G_OBJECT (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 (G_OBJECT (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;
}