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

你可以猜到,创建开关按钮应该和一般按钮构件相同。第一个函数是创建一个空白的开关按钮,后面两个函数创建带标签的开关按钮。其中 _mnemonic() 函数处理标签中的以 '_' 为前缀的助记语法符。

我们是通过读取开关构件 (包括单选和复选按钮) 结构的 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);

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