| GTK+ 3 Reference Manual | ||||
|---|---|---|---|---|
| Top | Description | Object Hierarchy | Implemented Interfaces | Properties | Style Properties | Signals | ||||
#include <gtk/gtk.h> struct GtkSwitch; GtkWidget * gtk_switch_new (void); void gtk_switch_set_active (GtkSwitch *sw,gboolean is_active); gboolean gtk_switch_get_active (GtkSwitch *sw);
GtkSwitch is a widget that has two states: on or off. The user can control which state should be active by clicking the empty area, or by dragging the handle.
struct GtkSwitch;
The GtkSwitch structure contains private data and it should only be accessed using the provided API.
GtkWidget * gtk_switch_new (void);
Creates a new GtkSwitch widget.
Returns : |
the newly created GtkSwitch instance |
Since 3.0
void gtk_switch_set_active (GtkSwitch *sw,gboolean is_active);
Changes the state of sw to the desired one.
|
a GtkSwitch |
|
TRUE if sw should be active, and FALSE otherwise |
Since 3.0
"active" property "active" gboolean : Read / Write
Whether the GtkSwitch widget is in its on or off state.
Default value: FALSE
"slider-width" style property "slider-width" gint : Read
The minimum width of the GtkSwitch handle, in pixels.
Allowed values: >= 36
Default value: 36
"activate" signalvoid user_function (GtkSwitch *widget,
gpointer user_data) : Action
The ::activate signal on GtkSwitch is an action signal and emitting it causes the switch to animate. Applications should never connect to this signal, but use the notify::active signal.
|
the object which received the signal. |
|
user data set when the signal handler was connected. |