开关按钮 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); 

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