![]() |
![]() |
![]() |
GTK+ Reference Manual | ![]() |
---|---|---|---|---|
#include <gtk/gtk.h> GtkToggleButton; GtkWidget* gtk_toggle_button_new (void); GtkWidget* gtk_toggle_button_new_with_label (constgchar *label); GtkWidget* gtk_toggle_button_new_with_mnemonic (constgchar *label);void gtk_toggle_button_set_mode (GtkToggleButton *toggle_button,gboolean draw_indicator);gboolean gtk_toggle_button_get_mode (GtkToggleButton *toggle_button); #define gtk_toggle_button_set_statevoid gtk_toggle_button_toggled (GtkToggleButton *toggle_button);gboolean gtk_toggle_button_get_active (GtkToggleButton *toggle_button);void gtk_toggle_button_set_active (GtkToggleButton *toggle_button,gboolean is_active);gboolean gtk_toggle_button_get_inconsistent (GtkToggleButton *toggle_button);void gtk_toggle_button_set_inconsistent (GtkToggleButton *toggle_button,gboolean setting);
GObject +----GInitiallyUnowned +----GtkObject +----GtkWidget +----GtkContainer +----GtkBin +----GtkButton +----GtkToggleButton +----GtkCheckButton
"active"gboolean : Read / Write "draw-indicator"gboolean : Read / Write "inconsistent"gboolean : Read / Write
"toggled"void user_function (GtkToggleButton *togglebutton,gpointer user_data) : Run first
A GtkToggleButton is a GtkButton which will remain 'pressed-in' when clicked. Clicking again will cause the toggle button to return to its normal state.
A toggle button is created by calling either gtk_toggle_button_new()
or
gtk_toggle_button_new_with_label()
. If using the former, it is advisable to
pack a widget, (such as a GtkLabel and/or a GtkPixmap), into the toggle
button's container. (See GtkButton for more information).
The state of a GtkToggleButton can be set specifically using
gtk_toggle_button_set_active()
, and retrieved using
gtk_toggle_button_get_active()
.
To simply switch the state of a toggle button, use gtk_toggle_button_toggled.
Example 2. Creating two GtkToggleButton widgets.
void make_toggles (void) { GtkWidget *dialog, *toggle1, *toggle2; dialog = gtk_dialog_new (); toggle1 = gtk_toggle_button_new_with_label ("Hi, i'm a toggle button."); /* Makes this toggle button invisible */ gtk_toggle_button_set_mode (GTK_TOGGLE_BUTTON (toggle1), TRUE); g_signal_connect (toggle1, "toggled", G_CALLBACK (output_state), NULL); gtk_box_pack_start (GTK_BOX (GTK_DIALOG (dialog)->action_area), toggle1, FALSE, FALSE, 2); toggle2 = gtk_toggle_button_new_with_label ("Hi, i'm another toggle button."); gtk_toggle_button_set_mode (GTK_TOGGLE_BUTTON (toggle2), FALSE); g_signal_connect (toggle2, "toggled", G_CALLBACK (output_state), NULL); gtk_box_pack_start (GTK_BOX (GTK_DIALOG (dialog)->action_area), toggle2, FALSE, FALSE, 2); gtk_widget_show_all (dialog); }
typedef struct _GtkToggleButton GtkToggleButton;
The GtkToggleButton struct contains private data only, and should be manipulated using the functions below.
GtkWidget* gtk_toggle_button_new (void);
Creates a new toggle button. A widget should be packed into the button, as in gtk_button_new()
.
Returns : | a new toggle button. |
GtkWidget* gtk_toggle_button_new_with_label (constgchar *label);
Creates a new toggle button with a text label.
label : |
a string containing the message to be placed in the toggle button. |
Returns : | a new toggle button. |
GtkWidget* gtk_toggle_button_new_with_mnemonic (constgchar *label);
Creates a new GtkToggleButton containing a label. The label
will be created using gtk_label_new_with_mnemonic()
, so underscores
in label
indicate the mnemonic for the button.
label : |
the text of the button, with an underscore in front of the mnemonic character |
Returns : | a new GtkToggleButton |
void gtk_toggle_button_set_mode (GtkToggleButton *toggle_button,gboolean draw_indicator);
Sets whether the button is displayed as a separate indicator and label.
You can call this function on a checkbutton or a radiobutton with
draw_indicator
= FALSE
This function only affects instances of classes like GtkCheckButton and GtkRadioButton that derive from GtkToggleButton, not instances of GtkToggleButton itself.
toggle_button : |
a GtkToggleButton |
draw_indicator : |
if TRUE FALSE |
gboolean gtk_toggle_button_get_mode (GtkToggleButton *toggle_button);
Retrieves whether the button is displayed as a separate indicator
and label. See gtk_toggle_button_set_mode()
.
toggle_button : |
a GtkToggleButton |
Returns : | TRUE |
#define gtk_toggle_button_set_state gtk_toggle_button_set_active
gtk_toggle_button_set_state
is deprecated and should not be used in newly-written code.
This is a deprecated macro, and is only maintained for compatibility reasons.
void gtk_toggle_button_toggled (GtkToggleButton *toggle_button);
Emits the toggled signal on the GtkToggleButton. There is no good reason for an application ever to call this function.
toggle_button : |
a GtkToggleButton. |
gboolean gtk_toggle_button_get_active (GtkToggleButton *toggle_button);
Queries a GtkToggleButton and returns its current state. Returns TRUE
FALSE
toggle_button : |
a GtkToggleButton. |
Returns : | a |
void gtk_toggle_button_set_active (GtkToggleButton *toggle_button,gboolean is_active);
Sets the status of the toggle button. Set to TRUE
FALSE
toggle_button : |
a GtkToggleButton. |
is_active : |
TRUE FALSE |
gboolean gtk_toggle_button_get_inconsistent (GtkToggleButton *toggle_button);
Gets the value set by gtk_toggle_button_set_inconsistent()
.
toggle_button : |
a GtkToggleButton |
Returns : | TRUE FALSE |
void gtk_toggle_button_set_inconsistent (GtkToggleButton *toggle_button,gboolean setting);
If the user has selected a range of elements (such as some text or
spreadsheet cells) that are affected by a toggle button, and the
current values in that range are inconsistent, you may want to
display the toggle in an "in between" state. This function turns on
"in between" display. Normally you would turn off the inconsistent
state again if the user toggles the toggle button. This has to be
done manually, gtk_toggle_button_set_inconsistent()
only affects
visual appearance, it doesn't affect the semantics of the button.
toggle_button : |
a GtkToggleButton |
setting : |
TRUE |
active
" property"active"gboolean : Read / Write
If the toggle button should be pressed in or not.
Default value: FALSE
draw-indicator
" property"draw-indicator"gboolean : Read / Write
If the toggle part of the button is displayed.
Default value: FALSE
void user_function (GtkToggleButton *togglebutton,gpointer user_data) : Run first
Should be connected if you wish to perform an action whenever the GtkToggleButton's state is changed.
togglebutton : |
the object which received the signal. |
user_data : |
user data set when the signal handler was connected. |
GtkButton | a more general button. |
GtkCheckButton | another way of presenting a toggle option. |
GtkCheckMenuItem | a GtkToggleButton as a menu item. |