GTK构件之微调按钮
GTK构件之微调按钮
1.微调按钮简介
微调按钮(Spin Button)构件通常用于让用户从一个取值范围你选择一个值。它由一个文本输入框和旁边的向上和向下两个按钮组成。点击某一个按钮会让文本输入框里的数值大小在一定范围你改变。文本输入框里也可以直接输入一个特定值。
微调按钮构件允许其中的数值没有小数位或具有指定的小数位，并且数值可以按一种可配置的方式增加或减小。在按钮较长时间呈按下状态时，构件的数值会根据工具按下时间的长短加速变化。
微调按钮用一个调整对象来维护该按钮能够取值的范围。微调按钮构件因此而具有了很强大的功能。
2.调整对象简介
GTK 有多种构件能够由用户通过鼠标或键盘进行调整，比如范围构件。还有一些构件，比如说 GtkText 和GtkViewport，内部都有一些可调整的属性。
很明显，当用户调整范围构件的值时，应用程序需要对值的变化进行响应。一种办法就是当构件的调整值发生变化时，让每个构件引发自己的信号,将新值传递到信号处理函数中，或者让它在构件的内部数据结构中查找构件的值。 但是，也许需要将这个调整值同时连接到几个构件上，使得调整一个值时，其它的构件都随之响应。最明显的示例就是将一个滚动条连接到一个视角构件(viewport)或者滚动的文本区(text area)上。如果每个构件都要有自己的设置或获取调整值的方法，程序员或许需要自己编写很复杂的信号处理函数，以便将这些不同构件之间的变化同步或相关联。
GTK用一个调整对象(Adjustment object)解决了这个问题。调整对象不是构件，但是为构件提供了一种以抽象、 灵活的方法来传递调整值信息。调整对象最明显的用处就是为范围构件(比如滚动条和比例构件)储存配置参数和值。 然而，因为调整对象是从 Object派生的，在其正常的数据结构之外，它还具有一些特殊的功能。 最重要的是，它们能 够引发信号，就像构件一样，这些信号不仅能够让程序对用户在可调整构件上的输入进行响应，还能在可调整构件之间透明地传播调整值。
在许多其它的构件中都能够看到调整对象的用处。比如进度条、 视角 、 滚动窗口等。
- 微调按钮中创建调整对象函数：
GtkAdjustment *gtk_adjustment_new (gdouble value,
gdouble lower,gdouble upper,
gdouble step_increment,gdouble page_increment,
gdouble page_size);
形参：value -- 微调按钮初始值
lower、upper --构件允许的最大值、最小值
step_increment --鼠标左键按下构件一次增加/减小的值
page_increment --鼠标右键下构件一次增加/减少的值
page_size --没有用到
返回值：返回微调按钮构件对象
- 微调按钮创建函数：
GtkWidget *gtk_spin_button_new (GtkAdjustment *adjustment,gdouble climb_rate,guint digits)
形参：adjustment --调整对象
climb_rate --指明构件数值变化的加速度(长时间按住按钮， 数值会加速变化)。介于0.0~1.0之间
digits --微调按就值小数位数
- 微调按钮参数配置函数：
void gtk_spin_button_configure( GtkSpinButton *spin_button,GtkAdjustment *adjustment,
gdouble climb_rate,guint digits );
形参：spin_button --微调按钮控件
adjustment --调整对象
climb_rate --指明构件数值变化的加速度(长时间按住按钮， 数值会加速变化)。介于0.0~1.0之间
digits --微调按就值小数位数
- 设置或获取构件内部使用的调整对象：
/*获取微调按钮调整对象信息*/
GtkAdjustment *gtk_spin_button_get_adjustment (GtkSpinButton *spin_button);
/*设置微调按钮调整对象信息*/
gtk_spin_button_set_adjustment (GtkSpinButton *spin_button,GtkAdjustment *adjustment);
- 设置微调按钮小数位数：
void gtk_spin_button_set_digits (GtkSpinButton *spin_button,guint digits)
形参：spin_button --微调按钮控件
digits --微调按钮数值小数位数
- 设置微调按钮数值：
void gtk_spin_button_set_value (GtkSpinButton *spin_button,gdouble value);
形参：spin_button --微调按钮控件
value-- 要设置的数值
- 获取按钮当前数值：
/*以整数方式获取当前按钮数值*/
gdouble gtk_spin_button_get_value ( GtkSpinButton *spin_button );
/*以小数方式获取当前按钮数值*/
gint gtk_spin_button_get_value_as_int( GtkSpinButton *spin_button );
- 以当前值为基准修改微调按钮数值：
void gtk_spin_button_spin( GtkSpinButton *spin_button,GtkSpinType direction,gdouble increment );
形参：spin_button --微调按钮控件
direction 取以下参数：
GTK_SPIN_STEP_FORWARD
GTK_SPIN_STEP_BACKWARD
GTK_SPIN_PAGE_FORWARD
GTK_SPIN_PAGE_BACKWARD
GTK_SPIN_HOME
GTK_SPIN_END
GTK_SPIN_USER_DEFINED
GTK_SPIN_STEP_FORWARD和GTK_SPIN_STEP_BACKWARD将构件的值按increment参数指定的数值增大或减小，除非increment参数是 0。这种情况下，构件的值将按与其相关联的调整对象的step_increment值改变。
GTK_SPIN_PAGE_FORWARD和GTK_SPIN_PAGE_BACKWARD只是简单地按increment参数改变微调按钮构件的值。
GTK_SPIN_HOME 将构件的值设置为相关联调整对象的范围的最小值。
GTK_SPIN_END 将构件的值设置为相关联调整对象的范围的最大值。
GTK_SPIN_USER_DEFINED简单地按指定的数值改变构件的数值。
- 限制微调按钮构件的文本框只能输入数值:
void gtk_spin_button_set_numeric (GtkSpinButton *spin_button,gboolean numeric)
形参：spin_button --微调按钮控件
numeric --TRUE 只能输入数字；FALSE 可以输入任意内容
- 设置让微调按钮构件在upper和lower之间循环：
void gtk_spin_button_set_wrap (GtkSpinButton *spin_button, gboolean wrap)
形参：spin_button --微调按钮控件
wrap --TRUE 当按钮值到达最小值再往下调整将变为最大值；最大值再往上调整将为最小值
FALSE 当按钮值到达最小值再往下调整将保持不变；最大值再往上调整保持不变
可以设置让微调按钮构件将其值圆整到最接近 step_increment 的值(在该微调按钮构件使用的调整对象中设置的)。用下面的函数实现：
void gtk_spin_button_set_snap_to_ticks( GtkSpinButton *spin_button,gboolean snap_to_ticks );
- 微调按钮构件的更新方式可以用下面的函数改变：
void gtk_spin_button_set_update_policy( GtkSpinButton*spin_button,GtkSpinButtonUpdatePolicy policy );
形参：spin_button --微调按钮控件
policy --可以取如下值：
GTK_UPDATE_ALWAYS
GTK_UPDATE_IF_VALID。
在GTK_UPDATE_IF_VALID方式下，微调按钮构件只有在输入文本是其调整对象指定范围你合法的值时才进行更新，否则文本会被重置为当前的值。
在GTK_UPDATE_ALWAYS方式下，我们将忽略在文本转换为数值时的错误。
- 更新微调按钮：
void gtk_spin_button_update( GtkSpinButton *spin_button );
3.微调按钮示例
本示例实现共能如下：
- 通过微调按钮数值日期(年、月、日)；
- 通过复选按钮选择微调按钮仅能输入数字；
- 设置数值的小数位数
- 退出按钮通过对话框提示是否退出，保存按钮提示保存成功；
#include