懒人听书,好看的小说,欢乐颂

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.微調按鈕示例

poYBAGOGttiAHAp7AAG13z1IBuA001.png#pic_center

??本示例實現共能如下：

通過微調按鈕數值日期(年、月、日)；
通過復選按鈕選擇微調按鈕僅能輸入數字；
設置數值的小數位數
退出按鈕通過對話框提示是否退出，保存按鈕提示保存成功；

#include 
#include 
/*微調按鈕回調函數*/
void spin_button_callback(GtkWidget *widget,gpointer data)
{
	GtkWidget *spinbutton=(GtkWidget *)data;
	int val;
	/*獲取當前微調按鈕的值*/
	val=gtk_spin_button_get_value_as_int(GTK_SPIN_BUTTON(widget));
	g_print("val=%dn",val);
	/*修改小數位數*/
	gtk_spin_button_set_digits(GTK_SPIN_BUTTON(spinbutton),val);
}
/*復選按鈕處理函數*/
void check_button_callback(GtkWidget *widget,gpointer data)
{
	GtkWidget *spinbutton=(GtkWidget *)data;
	if(gtk_toggle_button_get_active(GTK_TOGGLE_BUTTON(widget)))
	{
		/*設置微調按鈕只能輸入數字*/
		gtk_spin_button_set_numeric(GTK_SPIN_BUTTON(spinbutton),TRUE);
	}
	else
	{
		/*設置微調按鈕可以輸入任意內容*/
		gtk_spin_button_set_numeric(GTK_SPIN_BUTTON(spinbutton),FALSE);
	}
}
/*保存按鈕處理函數*/
void save_button_callback(GtkWidget *widget,gpointer data)
{
	g_print("保存n");
	GtkWidget *window=(GtkWidget *)data;
	GtkWidget *dialog;
	GtkWidget *label;
	dialog=gtk_dialog_new_with_buttons("保存", GTK_WINDOW(window),GTK_DIALOG_MODAL,NULL);
	gtk_window_set_default_size(GTK_WINDOW(dialog),100, 100);
	label=gtk_label_new("保存成功n");
	gtk_box_pack_start(GTK_BOX(GTK_DIALOG(dialog)->vbox),label,TRUE, TRUE,0);
	gtk_widget_show(label);
	gtk_widget_show(dialog);
}
GtkWidget *dialog;
/*對話框處理回調函數*/
void button_clicked_callback(GtkWidget *widget,gpointer data)
{
	char *pada=(gchar *)data;
	if(!strcmp(pada,"on"))
	{
		gtk_widget_destroy(dialog);//關閉對話框
	}
	if(!strcmp(pada,"ok"))
	{
		gtk_main_quit();
	}
}
/*退出按鈕處理函數*/
void quit_button_callback(GtkWidget *widget,gpointer data)
{
	g_print("退出n");
	GtkWidget *window=(GtkWidget *)data;
	GtkWidget *label;
	GtkWidget *table;
	GtkWidget *button;
	dialog=gtk_dialog_new_with_buttons("是否退出", GTK_WINDOW(window),GTK_DIALOG_MODAL,NULL);
	gtk_window_set_default_size(GTK_WINDOW(dialog),100, 100);
	label=gtk_label_new("是否退出");
	gtk_box_pack_start(GTK_BOX(GTK_DIALOG(dialog)->vbox),label,TRUE, TRUE,0);
	gtk_widget_show(label);

	/*創建組裝表*/
	table=gtk_table_new(1,0,FALSE);
	gtk_box_pack_start(GTK_BOX(GTK_DIALOG(dialog)->action_area),table,FALSE, FALSE, 0);
	gtk_widget_show(table);
	/*創建按鈕*/
	button=gtk_button_new_from_stock(GTK_STOCK_NO);
	gtk_table_attach_defaults(GTK_TABLE(table),button,0,1,0,1);
	gtk_widget_show(button);
	g_signal_connect(GTK_OBJECT(button),"clicked",G_CALLBACK(button_clicked_callback),"on");
	/*創建按鈕*/
	button=gtk_button_new_from_stock(GTK_STOCK_OK);
	gtk_table_attach_defaults(GTK_TABLE(table),button,1,2,0,1);
	g_signal_connect(GTK_OBJECT(button),"clicked",G_CALLBACK(button_clicked_callback),"ok");
	gtk_widget_show(button);
	gtk_widget_show(dialog);
}
int main(int argc,char *argv[])
{
	GtkWidget *window;
	GtkWidget *vbox,*box;
	GtkWidget *frame;
	GtkAdjustment *adjust;
	GtkWidget *table;
	GtkWidget *label;
	GtkWidget *spin_button,*spin_val_button;
	GtkWidget *check_button;
	GtkWidget *button;
	gtk_init(&argc,&argv);
	window=gtk_window_new(GTK_WINDOW_TOPLEVEL);
	gtk_window_set_title(GTK_WINDOW(window), "微調按鈕");
	gtk_window_set_default_size(GTK_WINDOW(window),320, 240);
	gtk_container_set_border_width(GTK_CONTAINER(window) ,5);
	g_signal_connect(G_OBJECT(window),"destroy",G_CALLBACK(gtk_main_quit),NULL);

	/*創建縱向盒*/
	vbox=gtk_vbox_new(FALSE,0);
	gtk_container_set_border_width(GTK_CONTAINER(vbox) ,2);
	gtk_container_add(GTK_CONTAINER(window),vbox);
	gtk_widget_show(vbox);
	/*創建框架構件*/
	frame=gtk_frame_new("日期設置");
	gtk_frame_set_label_align(GTK_FRAME(frame),1.0,0.5);
	/*設置框架構件風格*/
	gtk_frame_set_shadow_type (GTK_FRAME (frame), GTK_SHADOW_ETCHED_OUT);
	gtk_box_pack_start(GTK_BOX(vbox),frame, FALSE,TRUE,0);
	gtk_widget_show(frame);

	/*創建組裝表*/
	table=gtk_table_new(2,3,FALSE);
	gtk_container_add(GTK_CONTAINER(frame),table);
	/*設置列之間的間隔*/
	gtk_table_set_col_spacings(GTK_TABLE(table),20);
	gtk_widget_show(table);

	/*創建調整對象*/
	adjust=(GtkAdjustment *)gtk_adjustment_new(2022,1970,3000,1,1,0);
	/*創建微調按鈕*/
	spin_button=gtk_spin_button_new(adjust,0.5, 0);
	/*限制微調按鈕只能輸入數值*/
	gtk_spin_button_set_numeric(GTK_SPIN_BUTTON(spin_button),TRUE);
	/*設置按鈕達到最大值后再變為最小值*/
	gtk_spin_button_set_wrap (GTK_SPIN_BUTTON(spin_button), TRUE);
	gtk_table_attach_defaults (GTK_TABLE(table),spin_button,0,1,1,2);
	gtk_widget_show(spin_button);
	/*設置標簽*/
	label=gtk_label_new("年");
	gtk_table_attach_defaults(GTK_TABLE(table),label,0,1,0,1);
	
	gtk_widget_show(label);

	/*創建微調按鈕*/
	adjust=(GtkAdjustment *)gtk_adjustment_new(1,1,12,1,1,0);
	spin_button=gtk_spin_button_new(adjust,1, 0);
	gtk_spin_button_set_wrap (GTK_SPIN_BUTTON(spin_button), TRUE);
	gtk_table_attach_defaults (GTK_TABLE(table),spin_button,1,2,1,2);
	gtk_widget_show(spin_button);
	/*設置標簽*/
	label=gtk_label_new("月");
	gtk_table_attach_defaults(GTK_TABLE(table),label,1,2,0,1);
	gtk_widget_show(label);

	/*創建微調按鈕*/
	adjust=(GtkAdjustment *)gtk_adjustment_new(1,1,31,1,1,0);
	spin_button=gtk_spin_button_new(adjust,0.5, 0);
	gtk_spin_button_set_wrap (GTK_SPIN_BUTTON(spin_button), TRUE);
	gtk_table_attach_defaults (GTK_TABLE(table),spin_button,2,3,1,2);
	gtk_widget_show(spin_button);
	/*設置標簽*/
	label=gtk_label_new("日");
	gtk_table_attach_defaults(GTK_TABLE(table),label,2,3,0,1);
	gtk_widget_show(label);

	/*創建框架構件*/
	frame=gtk_frame_new("數值調整");
	gtk_frame_set_label_align(GTK_FRAME(frame),0.5,0.5);
	gtk_frame_set_shadow_type (GTK_FRAME (frame), GTK_SHADOW_ETCHED_OUT);
	gtk_box_pack_start(GTK_BOX(vbox),frame, FALSE,TRUE,0);
	gtk_widget_show(frame);
	/*創建縱向向盒*/
	box=gtk_vbox_new(FALSE,0);
	gtk_container_add(GTK_CONTAINER(frame),box);
	gtk_widget_show(box);
	/*創建組裝表*/
	table=gtk_table_new(2,2,FALSE);
	gtk_box_pack_start(GTK_BOX(box),table,TRUE,TRUE,0);
	/*設置列之間的間隔*/
	gtk_table_set_col_spacings(GTK_TABLE(table),10);
	gtk_widget_show(table);	
	/*創建調整對象*/
	adjust=(GtkAdjustment *)gtk_adjustment_new(0,-5000,5000,0.5,0.5,0);
	spin_val_button=gtk_spin_button_new(adjust,0.5, 2);
	gtk_table_attach_defaults (GTK_TABLE(table),spin_val_button,0,1,1,2);
	gtk_widget_show(spin_val_button);
	/*設置標簽*/
	label=gtk_label_new("數值");
	gtk_table_attach_defaults(GTK_TABLE(table),label,0,1,0,1);
	gtk_widget_show(label);

	/*創建調整對象*/
	adjust=(GtkAdjustment *)gtk_adjustment_new(2,0,6,1,1,0);
	spin_button=gtk_spin_button_new(adjust,0.5, 0);
	g_signal_connect(G_OBJECT(spin_button),"value_changed",G_CALLBACK(spin_button_callback), spin_val_button);
	gtk_table_attach_defaults (GTK_TABLE(table),spin_button,1,2,1,2);
	gtk_widget_show(spin_button);
	/*設置標簽*/
	label=gtk_label_new("小數位數");
	gtk_table_attach_defaults(GTK_TABLE(table),label,1,2,0,1);
	gtk_widget_show(label);

	/*創建復選按鈕*/
	check_button=gtk_check_button_new_with_label("僅輸入數字");
	gtk_box_pack_start(GTK_BOX(box),check_button,FALSE,FALSE,0);
	g_signal_connect(G_OBJECT(check_button),"toggled",G_CALLBACK(check_button_callback), spin_button);
	gtk_widget_show(check_button);

	/*創建橫向盒*/
	box=gtk_hbox_new(FALSE,0);
	gtk_box_pack_start(GTK_BOX(vbox),box,TRUE,TRUE,0);
	gtk_widget_show(box);
	
	/*創建保存按鈕*/
	button=gtk_button_new_with_label("退出");
	gtk_box_pack_start(GTK_BOX(box),button,FALSE,FALSE,0);
	g_signal_connect(G_OBJECT(button),"clicked",G_CALLBACK(quit_button_callback),window);
	gtk_widget_show(button);
	
	/*創建保存按鈕*/
	button=gtk_button_new_with_label("保存");
	gtk_box_pack_end(GTK_BOX(box),button,FALSE,FALSE,0);
	g_signal_connect(G_OBJECT(button),"clicked",G_CALLBACK(save_button_callback),window);
	gtk_widget_show(button);
	gtk_widget_show(window);
	gtk_main();
}

審核編輯：湯梓紅

聲明：本文內容及配圖由入駐作者撰寫或者入駐合作網站授權轉載。文章觀點僅代表作者本人，不代表電子發燒友網立場。文章及其配圖僅供工程師學習之用，如有內容侵權或者其他違規問題，請聯系本站處理。舉報投訴