开关按钮 Toggle Buttons

开关按钮由一般按钮派生而来,并且非常相似,只是开关按钮有两个状态,通过点击可以水平切换。

开关按钮可以是被按下的(depressed),当你再点击一下,他们会弹起来。再点击一下,它们又会再弹下去。

开关按钮是复选按钮和单选按钮的基础,所以单选按钮和复选按钮继承了许多开关按钮的函数调用。我会在讲到它们时指出这些来。

创建开关按钮

创建一个新的开关按钮:

//创建一个空白的开关按钮:
GtkWidget *gtk_toggle_button_new( void );

//创建带标签的开关按钮:
GtkWidget *gtk_toggle_button_new_with_label( const gchar *label );

//创建带标签的开关按钮: 处理标签中的以 '_' 为前缀的助记语法符。
GtkWidget *gtk_toggle_button_new_with_mnemonic( const gchar *label );

开关按钮的回调函数

我们是通过读取开关按钮控件 (包括单选和复选按钮) 结构的 active 域,来检测开关按钮的状态。之前要用 GTK_TOGGLE_BUTTON 宏把控件指针转换为开关控件指针。我们关心的各种开关按钮 (开关按钮、复选按钮和单选按钮控件) 的信号是 “toggled” 信号。为了检测这些按钮的状态,设置一个处理回调函数以捕获 “toggled” 信号,并且通过读取结构测定它的状态。该回调函数如下:

void toggle_button_callback (GtkWidget *widget, gpointer data)
{
    if (gtk_toggle_button_get_active (GTK_TOGGLE_BUTTON (widget))) 
    {
        /* 如果运行到这里,开关按钮是按下的 */

    } else {
        /* 如果运行到这里,开关按钮是弹起的 */

    }
}

设置开关按钮的状态

设置开关按钮和它的孩子 (即单选和复选按钮) 的状态,用如下函数:

void gtk_toggle_button_set_active( GtkToggleButton *toggle_button,
                                   gboolean        is_active );

上面的调用可以用来设置开关按钮,以及它的孩子单选和复选按钮的状态。将你所创建的按钮作为第一个参数传入,以及一个 TRUE 或 FALSE 值作为第二个状态参数来指定它应该是下 (按下) 还是上 (弹起)。默认是上,即 FALSE。

注意:当你使用 gtk_toggle_button_set_active() 函数,并且状态也实际改变了时,它会导致按钮发出 “clicked” 和 “toggled” 信号。

读取开关按钮的状态

gboolean gtk_toggle_button_get_active    (GtkToggleButton *toggle_button); 

返回值是开关按钮的当前状态。