/* GTK - The GIMP Toolkit
*
* Copyright ( C ) 2010 Intel Corporation
* Copyright ( C ) 2010 RedHat , Inc .
*
* This library is free software ; you can redistribute it and / or
* modify it under the terms of the GNU Lesser General Public
* License as published by the Free Software Foundation ; either
* version 2 of the License , or ( at your option ) any later version .
*
* This library is distributed in the hope that it will be useful ,
* but WITHOUT ANY WARRANTY ; without even the implied warranty of
* MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE . See the GNU
* Lesser General Public License for more details .
*
* You should have received a copy of the GNU Lesser General Public
* License along with this library . If not , see < http : //www.gnu.org/licenses/>.
*
* Author :
* Emmanuele Bassi < ebassi @ linux . intel . com >
* Matthias Clasen < mclasen @ redhat . com >
*
* Based on similar code from Mx .
*/
/**
* GtkSwitch :
*
* Shows a " light switch " that has two states : on or off .
*
* < picture >
* < source srcset = " switch - dark . png " media = " ( prefers - color - scheme : dark ) " >
* < img alt = " An example GtkSwitch " src = " switch . png " >
* < / picture >
*
* The user can control which state should be active by clicking the
* empty area , or by dragging the slider .
*
* ` GtkSwitch ` can also express situations where the underlying state changes
* with a delay . In this case , the slider position indicates the user ' s recent
* change ( represented by the [ property @ Gtk . Switch : active ] property ) , while the
* trough color indicates the present underlying state ( represented by the
* [ property @ Gtk . Switch : state ] property ) .
*
* < picture >
* < source srcset = " switch - state - dark . png " media = " ( prefers - color - scheme : dark ) " >
* < img alt = " GtkSwitch with delayed state change " src = " switch - state . png " >
* < / picture >
*
* See [ signal @ Gtk . Switch : : state - set ] for details .
*
* # Shortcuts and Gestures
*
* ` GtkSwitch ` supports pan and drag gestures to move the slider .
*
* # CSS nodes
*
* ` ` `
* switch
* ├ ─ ─ image
* ├ ─ ─ image
* ╰ ─ ─ slider
* ` ` `
*
* ` GtkSwitch ` has four css nodes , the main node with the name switch and
* subnodes for the slider and the on and off images . Neither of them is
* using any style classes .
*
* # Accessibility
*
* ` GtkSwitch ` uses the [ enum @ Gtk . AccessibleRole . switch ] role .
*/
#include "config.h"
#include "gtkswitch.h"
#include "gtkactionable.h"
#include "gtkactionhelperprivate.h"
#include "gtkgestureclick.h"
#include "gtkgesturepan.h"
#include "gtkgesturesingle.h"
#include "gtkgizmoprivate.h"
#include "gtkimage.h"
#include "gtkcustomlayout.h"
#include "gtkmarshalers.h"
#include "gtkprivate.h"
#include "gtkprogresstrackerprivate.h"
#include "gtksettingsprivate.h"
#include "gtkwidgetprivate.h"
typedef struct _GtkSwitchClass GtkSwitchClass;
struct _GtkSwitch
{
GtkWidget parent_instance;
GtkActionHelper *action_helper;
GtkGesture *pan_gesture;
GtkGesture *click_gesture;
double handle_pos;
guint tick_id;
guint state : 1 ;
guint is_active : 1 ;
GtkProgressTracker tracker;
GtkWidget *on_image;
GtkWidget *off_image;
GtkWidget *slider;
};
struct _GtkSwitchClass
{
GtkWidgetClass parent_class;
void (* activate) (GtkSwitch *self);
gboolean (* state_set) (GtkSwitch *self,
gboolean state);
};
enum
{
PROP_0,
PROP_ACTIVE,
PROP_STATE,
/* GtkActionable */
PROP_ACTION_NAME,
PROP_ACTION_TARGET,
LAST_PROP
};
enum
{
ACTIVATE,
STATE_SET,
LAST_SIGNAL
};
static guint signals[LAST_SIGNAL] = { 0 };
static GParamSpec *switch_props[LAST_PROP] = { NULL, };
static void gtk_switch_actionable_iface_init (GtkActionableInterface *iface);
G_DEFINE_TYPE_WITH_CODE (GtkSwitch, gtk_switch, GTK_TYPE_WIDGET,
G_IMPLEMENT_INTERFACE (GTK_TYPE_ACTIONABLE,
gtk_switch_actionable_iface_init))
static gboolean
is_right_side (GtkWidget *widget,
gboolean active)
{
if (_gtk_widget_get_direction (widget) == GTK_TEXT_DIR_LTR)
return active;
else
return !active;
}
static void
gtk_switch_end_toggle_animation (GtkSwitch *self)
{
if (self->tick_id != 0 )
{
gtk_widget_remove_tick_callback (GTK_WIDGET (self), self->tick_id);
self->tick_id = 0 ;
}
}
static gboolean
gtk_switch_on_frame_clock_update (GtkWidget *widget,
GdkFrameClock *clock,
gpointer user_data)
{
GtkSwitch *self = GTK_SWITCH (widget);
double progress;
gtk_progress_tracker_advance_frame (&self->tracker,
gdk_frame_clock_get_frame_time (clock));
if (gtk_progress_tracker_get_state (&self->tracker) != GTK_PROGRESS_STATE_AFTER)
{
progress = gtk_progress_tracker_get_ease_out_cubic (&self->tracker, FALSE );
if (is_right_side (widget, self->is_active))
self->handle_pos = 1 .0 - progress;
else
self->handle_pos = progress;
}
else
{
gtk_switch_set_active (self, !self->is_active);
}
gtk_widget_queue_allocate (GTK_WIDGET (self));
return G_SOURCE_CONTINUE;
}
#define ANIMATION_DURATION 100
static void
gtk_switch_begin_toggle_animation (GtkSwitch *self)
{
if (gtk_settings_get_enable_animations (gtk_widget_get_settings (GTK_WIDGET (self))))
{
gtk_progress_tracker_start (&self->tracker, 1000 * ANIMATION_DURATION, 0 , 1 .0 );
if (self->tick_id == 0 )
self->tick_id = gtk_widget_add_tick_callback (GTK_WIDGET (self),
gtk_switch_on_frame_clock_update,
NULL, NULL);
}
else
{
gtk_switch_set_active (self, !self->is_active);
}
}
static void
gtk_switch_click_gesture_pressed (GtkGestureClick *gesture,
int n_press,
double x,
double y,
GtkSwitch *self)
{
graphene_rect_t switch_bounds;
if (!gtk_widget_compute_bounds (GTK_WIDGET (self), GTK_WIDGET (self), &switch_bounds))
return ;
/* If the press didn't happen in the draggable handle,
* cancel the pan gesture right away
*/
if ((self->is_active && x <= switch_bounds.size.width / 2 .0 ) ||
(!self->is_active && x > switch_bounds.size.width / 2 .0 ))
gtk_gesture_set_state (self->pan_gesture, GTK_EVENT_SEQUENCE_DENIED);
}
static void
gtk_switch_click_gesture_released (GtkGestureClick *gesture,
int n_press,
double x,
double y,
GtkSwitch *self)
{
GdkEventSequence *sequence;
sequence = gtk_gesture_single_get_current_sequence (GTK_GESTURE_SINGLE (gesture));
if (gtk_widget_contains (GTK_WIDGET (self), x, y) &&
gtk_gesture_handles_sequence (GTK_GESTURE (gesture), sequence))
{
gtk_gesture_set_state (GTK_GESTURE (gesture), GTK_EVENT_SEQUENCE_CLAIMED);
gtk_switch_begin_toggle_animation (self);
}
}
static void
gtk_switch_pan_gesture_pan (GtkGesturePan *gesture,
GtkPanDirection direction,
double offset,
GtkSwitch *self)
{
GtkWidget *widget = GTK_WIDGET (self);
int width;
width = gtk_widget_get_width (widget);
if (direction == GTK_PAN_DIRECTION_LEFT)
offset = -offset;
gtk_gesture_set_state (GTK_GESTURE (gesture), GTK_EVENT_SEQUENCE_CLAIMED);
if (is_right_side (widget, self->is_active))
offset += width / 2 ;
offset /= width / 2 ;
/* constrain the handle within the trough width */
self->handle_pos = CLAMP (offset, 0 , 1 .0 );
/* we need to redraw the handle */
gtk_widget_queue_allocate (widget);
}
static void
gtk_switch_pan_gesture_drag_end (GtkGestureDrag *gesture,
double x,
double y,
GtkSwitch *self)
{
GtkWidget *widget = GTK_WIDGET (self);
GdkEventSequence *sequence;
gboolean active;
sequence = gtk_gesture_single_get_current_sequence (GTK_GESTURE_SINGLE (gesture));
if (gtk_gesture_get_sequence_state (GTK_GESTURE (gesture), sequence) == GTK_EVENT_SEQUENCE_CLAIMED)
{
/* if half the handle passed the middle of the switch, then we
* consider it to be on
*/
if (_gtk_widget_get_direction (widget) == GTK_TEXT_DIR_LTR)
active = self->handle_pos >= 0 .5 ;
else
active = self->handle_pos <= 0 .5 ;
}
else if (!gtk_gesture_handles_sequence (self->click_gesture, sequence))
active = self->is_active;
else
return ;
self->handle_pos = is_right_side (widget, active) ? 1 .0 : 0 .0 ;
gtk_switch_set_active (self, active);
gtk_widget_queue_allocate (widget);
}
static void
gtk_switch_activate (GtkSwitch *self)
{
gtk_switch_begin_toggle_animation (self);
}
static void
gtk_switch_measure (GtkWidget *widget,
GtkOrientation orientation,
int for_size,
int *minimum,
int *natural,
int *minimum_baseline,
int *natural_baseline)
{
GtkSwitch *self = GTK_SWITCH (widget);
int slider_minimum, slider_natural;
int on_nat, off_nat;
int on_baseline, off_baseline;
gtk_widget_measure (self->slider, orientation, -1 ,
&slider_minimum, &slider_natural,
NULL, NULL);
gtk_widget_measure (self->on_image, orientation, for_size, NULL, &on_nat, NULL, &on_baseline);
gtk_widget_measure (self->off_image, orientation, for_size, NULL, &off_nat, NULL, &off_baseline);
if (orientation == GTK_ORIENTATION_HORIZONTAL)
{
int text_width = MAX (on_nat, off_nat);
*minimum = 2 * MAX (slider_minimum, text_width);
*natural = 2 * MAX (slider_natural, text_width);
}
else
{
int text_height = MAX (on_nat, off_nat);
*minimum = MAX (slider_minimum, text_height);
*natural = MAX (slider_natural, text_height);
*minimum_baseline = MAX (on_baseline, off_baseline) + MAX ((slider_minimum - text_height) / 2 , 0 );
*natural_baseline = MAX (on_baseline, off_baseline) + MAX ((slider_natural - text_height) / 2 , 0 );
}
}
static void
gtk_switch_allocate (GtkWidget *widget,
int width,
int height,
int baseline)
{
GtkSwitch *self = GTK_SWITCH (widget);
GtkAllocation child_alloc;
int min;
gtk_widget_size_allocate (self->slider,
&(GtkAllocation) {
round (self->handle_pos * (width / 2 )), 0 ,
width / 2 , height
}, -1 );
/* Center ON icon in left half */
gtk_widget_measure (self->on_image, GTK_ORIENTATION_HORIZONTAL, -1 , &min, NULL, NULL, NULL);
child_alloc.x = ((width / 2 ) - min) / 2 ;
if (is_right_side (widget, FALSE ))
child_alloc.x += width / 2 ;
child_alloc.width = min;
gtk_widget_measure (self->on_image, GTK_ORIENTATION_VERTICAL, min, &min, NULL, NULL, NULL);
child_alloc.y = (height - min) / 2 ;
child_alloc.height = min;
gtk_widget_size_allocate (self->on_image, &child_alloc, -1 );
/* Center OFF icon in right half */
gtk_widget_measure (self->off_image, GTK_ORIENTATION_HORIZONTAL, -1 , &min, NULL, NULL, NULL);
child_alloc.x = ((width / 2 ) - min) / 2 ;
if (is_right_side (widget, TRUE ))
child_alloc.x += width / 2 ;
child_alloc.width = min;
gtk_widget_measure (self->off_image, GTK_ORIENTATION_VERTICAL, min, &min, NULL, NULL, NULL);
child_alloc.y = (height - min) / 2 ;
child_alloc.height = min;
gtk_widget_size_allocate (self->off_image, &child_alloc, -1 );
}
static void
gtk_switch_direction_changed (GtkWidget *widget,
GtkTextDirection previous_dir)
{
GtkSwitch *self = GTK_SWITCH (widget);
self->handle_pos = 1 .0 - self->handle_pos;
gtk_widget_queue_allocate (widget);
GTK_WIDGET_CLASS (gtk_switch_parent_class)->direction_changed (widget, previous_dir);
}
static void
gtk_switch_set_action_name (GtkActionable *actionable,
const char *action_name)
{
GtkSwitch *self = GTK_SWITCH (actionable);
if (!self->action_helper)
self->action_helper = gtk_action_helper_new (actionable);
gtk_action_helper_set_action_name (self->action_helper, action_name);
}
static void
gtk_switch_set_action_target_value (GtkActionable *actionable,
GVariant *action_target)
{
GtkSwitch *self = GTK_SWITCH (actionable);
if (!self->action_helper)
self->action_helper = gtk_action_helper_new (actionable);
gtk_action_helper_set_action_target_value (self->action_helper, action_target);
}
static const char *
gtk_switch_get_action_name (GtkActionable *actionable)
{
GtkSwitch *self = GTK_SWITCH (actionable);
return gtk_action_helper_get_action_name (self->action_helper);
}
static GVariant *
gtk_switch_get_action_target_value (GtkActionable *actionable)
{
GtkSwitch *self = GTK_SWITCH (actionable);
return gtk_action_helper_get_action_target_value (self->action_helper);
}
static void
gtk_switch_actionable_iface_init (GtkActionableInterface *iface)
{
iface->get_action_name = gtk_switch_get_action_name;
iface->set_action_name = gtk_switch_set_action_name;
iface->get_action_target_value = gtk_switch_get_action_target_value;
iface->set_action_target_value = gtk_switch_set_action_target_value;
}
static void
gtk_switch_set_property (GObject *gobject,
guint prop_id,
const GValue *value,
GParamSpec *pspec)
{
GtkSwitch *self = GTK_SWITCH (gobject);
switch (prop_id)
{
case PROP_ACTIVE:
gtk_switch_set_active (self, g_value_get_boolean (value));
break ;
case PROP_STATE:
gtk_switch_set_state (self, g_value_get_boolean (value));
break ;
case PROP_ACTION_NAME:
gtk_switch_set_action_name (GTK_ACTIONABLE (self), g_value_get_string (value));
break ;
case PROP_ACTION_TARGET:
gtk_switch_set_action_target_value (GTK_ACTIONABLE (self), g_value_get_variant (value));
break ;
default :
G_OBJECT_WARN_INVALID_PROPERTY_ID (gobject, prop_id, pspec);
}
}
static void
gtk_switch_get_property (GObject *gobject,
guint prop_id,
GValue *value,
GParamSpec *pspec)
{
GtkSwitch *self = GTK_SWITCH (gobject);
switch (prop_id)
{
case PROP_ACTIVE:
g_value_set_boolean (value, self->is_active);
break ;
case PROP_STATE:
g_value_set_boolean (value, self->state);
break ;
case PROP_ACTION_NAME:
g_value_set_string (value, gtk_action_helper_get_action_name (self->action_helper));
break ;
case PROP_ACTION_TARGET:
g_value_set_variant (value, gtk_action_helper_get_action_target_value (self->action_helper));
break ;
default :
G_OBJECT_WARN_INVALID_PROPERTY_ID (gobject, prop_id, pspec);
}
}
static void
gtk_switch_dispose (GObject *object)
{
GtkSwitch *self = GTK_SWITCH (object);
g_clear_object (&self->action_helper);
G_OBJECT_CLASS (gtk_switch_parent_class)->dispose (object);
}
static void
gtk_switch_finalize (GObject *object)
{
GtkSwitch *self = GTK_SWITCH (object);
gtk_switch_end_toggle_animation (self);
gtk_widget_unparent (self->on_image);
gtk_widget_unparent (self->off_image);
gtk_widget_unparent (self->slider);
G_OBJECT_CLASS (gtk_switch_parent_class)->finalize (object);
}
static gboolean
state_set (GtkSwitch *self,
gboolean state)
{
if (self->action_helper)
gtk_action_helper_activate (self->action_helper);
gtk_switch_set_state (self, state);
return TRUE ;
}
static gboolean
translate_switch_shapes_to_opacity (GBinding *binding,
const GValue *from_value,
GValue *to_value,
gpointer user_data)
{
gboolean visible = g_value_get_boolean (from_value);
g_value_set_double (to_value, visible ? 1 .0 : 0 .0 );
return TRUE ;
}
static void
gtk_switch_class_init (GtkSwitchClass *klass)
{
GtkWidgetClass *widget_class = GTK_WIDGET_CLASS (klass);
GObjectClass *gobject_class = G_OBJECT_CLASS (klass);
/**
* GtkSwitch : active :
*
* Whether the ` GtkSwitch ` widget is in its on or off state .
*/
switch_props[PROP_ACTIVE] =
g_param_spec_boolean ("active" , NULL, NULL,
FALSE ,
G_PARAM_READWRITE | G_PARAM_STATIC_NAME | G_PARAM_EXPLICIT_NOTIFY);
/**
* GtkSwitch : state :
*
* The backend state that is controlled by the switch .
*
* Applications should usually set the [ property @ Gtk . Switch : active ] property ,
* except when indicating a change to the backend state which occurs
* separately from the user ' s interaction .
*
* See [ signal @ Gtk . Switch : : state - set ] for details .
*/
switch_props[PROP_STATE] =
g_param_spec_boolean ("state" , NULL, NULL,
FALSE ,
G_PARAM_READWRITE | G_PARAM_STATIC_NAME | G_PARAM_EXPLICIT_NOTIFY);
gobject_class->set_property = gtk_switch_set_property;
gobject_class->get_property = gtk_switch_get_property;
gobject_class->dispose = gtk_switch_dispose;
gobject_class->finalize = gtk_switch_finalize;
widget_class->direction_changed = gtk_switch_direction_changed;
klass->activate = gtk_switch_activate;
klass->state_set = state_set;
/**
* GtkSwitch : : activate :
* @ widget : the object which received the signal
*
* Emitted to animate the switch .
*
* Applications should never connect to this signal ,
* but use the [ property @ Gtk . Switch : active ] property .
*/
signals[ACTIVATE] =
g_signal_new (I_("activate" ),
G_OBJECT_CLASS_TYPE (gobject_class),
G_SIGNAL_RUN_FIRST | G_SIGNAL_ACTION,
G_STRUCT_OFFSET (GtkSwitchClass, activate),
NULL, NULL,
NULL,
G_TYPE_NONE, 0 );
gtk_widget_class_set_activate_signal (widget_class, signals[ACTIVATE]);
/**
* GtkSwitch : : state - set :
* @ widget : the object on which the signal was emitted
* @ state : the new state of the switch
*
* Emitted to change the underlying state .
*
* The : : state - set signal is emitted when the user changes the switch
* position . The default handler calls [ method @ Gtk . Switch . set_state ] with the
* value of @ state .
*
* To implement delayed state change , applications can connect to this
* signal , initiate the change of the underlying state , and call
* [ method @ Gtk . Switch . set_state ] when the underlying state change is
* complete . The signal handler should return % TRUE to prevent the
* default handler from running .
*
* Returns : % TRUE to stop the signal emission
*/
signals[STATE_SET] =
g_signal_new (I_("state-set" ),
G_OBJECT_CLASS_TYPE (gobject_class),
G_SIGNAL_RUN_LAST,
G_STRUCT_OFFSET (GtkSwitchClass, state_set),
_gtk_boolean_handled_accumulator, NULL,
_gtk_marshal_BOOLEAN__BOOLEAN,
G_TYPE_BOOLEAN, 1 ,
G_TYPE_BOOLEAN);
g_signal_set_va_marshaller (signals[STATE_SET],
G_TYPE_FROM_CLASS (gobject_class),
_gtk_marshal_BOOLEAN__BOOLEANv);
switch_props[PROP_ACTION_NAME] = g_param_spec_override ("action-name" ,
g_object_interface_find_property (g_type_default_interface_ref (GTK_TYPE_ACTIONABLE), "action-name" ));
switch_props[PROP_ACTION_TARGET] = g_param_spec_override ("action-target" ,
g_object_interface_find_property (g_type_default_interface_ref (GTK_TYPE_ACTIONABLE), "action-target" ));
g_object_class_install_properties (gobject_class, LAST_PROP, switch_props);
gtk_widget_class_set_css_name (widget_class, I_("switch" ));
gtk_widget_class_set_accessible_role (widget_class, GTK_ACCESSIBLE_ROLE_SWITCH);
}
static void
gtk_switch_init (GtkSwitch *self)
{
GtkLayoutManager *layout;
GtkGesture *gesture;
GtkSettings *gtk_settings;
gtk_widget_set_focusable (GTK_WIDGET (self), TRUE );
gesture = gtk_gesture_click_new ();
gtk_gesture_single_set_touch_only (GTK_GESTURE_SINGLE (gesture), FALSE );
gtk_gesture_single_set_exclusive (GTK_GESTURE_SINGLE (gesture), TRUE );
g_signal_connect (gesture, "pressed" ,
G_CALLBACK (gtk_switch_click_gesture_pressed), self);
g_signal_connect (gesture, "released" ,
G_CALLBACK (gtk_switch_click_gesture_released), self);
gtk_event_controller_set_propagation_phase (GTK_EVENT_CONTROLLER (gesture),
GTK_PHASE_BUBBLE);
gtk_widget_add_controller (GTK_WIDGET (self), GTK_EVENT_CONTROLLER (gesture));
self->click_gesture = gesture;
gesture = gtk_gesture_pan_new (GTK_ORIENTATION_HORIZONTAL);
gtk_gesture_single_set_touch_only (GTK_GESTURE_SINGLE (gesture), FALSE );
gtk_gesture_single_set_exclusive (GTK_GESTURE_SINGLE (gesture), TRUE );
g_signal_connect (gesture, "pan" ,
G_CALLBACK (gtk_switch_pan_gesture_pan), self);
g_signal_connect (gesture, "drag-end" ,
G_CALLBACK (gtk_switch_pan_gesture_drag_end), self);
gtk_event_controller_set_propagation_phase (GTK_EVENT_CONTROLLER (gesture),
GTK_PHASE_CAPTURE);
gtk_widget_add_controller (GTK_WIDGET (self), GTK_EVENT_CONTROLLER (gesture));
self->pan_gesture = gesture;
layout = gtk_custom_layout_new (NULL,
gtk_switch_measure,
gtk_switch_allocate);
gtk_widget_set_layout_manager (GTK_WIDGET (self), layout);
gtk_settings = gtk_settings_get_default ();
self->on_image = g_object_new (GTK_TYPE_IMAGE,
"accessible-role" , GTK_ACCESSIBLE_ROLE_NONE,
"icon-name" , "switch-on-symbolic" ,
NULL);
gtk_widget_set_parent (self->on_image, GTK_WIDGET (self));
g_object_bind_property_full (gtk_settings, "gtk-show-status-shapes" ,
self->on_image, "opacity" ,
G_BINDING_SYNC_CREATE,
translate_switch_shapes_to_opacity,
NULL, NULL, NULL);
self->off_image = g_object_new (GTK_TYPE_IMAGE,
"accessible-role" , GTK_ACCESSIBLE_ROLE_NONE,
"icon-name" , "switch-off-symbolic" ,
NULL);
gtk_widget_set_parent (self->off_image, GTK_WIDGET (self));
g_object_bind_property_full (gtk_settings, "gtk-show-status-shapes" ,
self->off_image, "opacity" ,
G_BINDING_SYNC_CREATE,
translate_switch_shapes_to_opacity,
NULL, NULL, NULL);
self->slider = gtk_gizmo_new_with_role ("slider" ,
GTK_ACCESSIBLE_ROLE_NONE,
NULL, NULL, NULL, NULL, NULL, NULL);
gtk_widget_set_parent (self->slider, GTK_WIDGET (self));
gtk_accessible_update_state (GTK_ACCESSIBLE (self),
GTK_ACCESSIBLE_STATE_CHECKED, FALSE ,
-1 );
if (is_right_side (GTK_WIDGET (self), FALSE ))
self->handle_pos = 1 .0 ;
else
self->handle_pos = 0 .0 ;
}
/**
* gtk_switch_new :
*
* Creates a new ` GtkSwitch ` widget .
*
* Returns : the newly created ` GtkSwitch ` instance
*/
GtkWidget *
gtk_switch_new (void )
{
return g_object_new (GTK_TYPE_SWITCH, NULL);
}
/**
* gtk_switch_set_active :
* @ self : a ` GtkSwitch `
* @ is_active : % TRUE if @ self should be active , and % FALSE otherwise
*
* Changes the state of @ self to the desired one .
*/
void
gtk_switch_set_active (GtkSwitch *self,
gboolean is_active)
{
g_return_if_fail (GTK_IS_SWITCH (self));
gtk_switch_end_toggle_animation (self);
is_active = !!is_active;
if (self->is_active != is_active)
{
gboolean handled;
self->is_active = is_active;
if (is_right_side (GTK_WIDGET (self), self->is_active))
self->handle_pos = 1 .0 ;
else
self->handle_pos = 0 .0 ;
g_signal_emit (self, signals[STATE_SET], 0 , is_active, &handled);
g_object_notify_by_pspec (G_OBJECT (self), switch_props[PROP_ACTIVE]);
gtk_accessible_update_state (GTK_ACCESSIBLE (self),
GTK_ACCESSIBLE_STATE_CHECKED, is_active,
-1 );
gtk_widget_queue_allocate (GTK_WIDGET (self));
}
}
/**
* gtk_switch_get_active :
* @ self : a ` GtkSwitch `
*
* Gets whether the ` GtkSwitch ` is in its “ on ” or “ off ” state .
*
* Returns : % TRUE if the ` GtkSwitch ` is active , and % FALSE otherwise
*/
gboolean
gtk_switch_get_active (GtkSwitch *self)
{
g_return_val_if_fail (GTK_IS_SWITCH (self), FALSE );
return self->is_active;
}
/**
* gtk_switch_set_state :
* @ self : a ` GtkSwitch `
* @ state : the new state
*
* Sets the underlying state of the ` GtkSwitch ` .
*
* This function is typically called from a [ signal @ Gtk . Switch : : state - set ]
* signal handler in order to set up delayed state changes .
*
* See [ signal @ Gtk . Switch : : state - set ] for details .
*/
void
gtk_switch_set_state (GtkSwitch *self,
gboolean state)
{
g_return_if_fail (GTK_IS_SWITCH (self));
state = state != FALSE ;
if (self->state == state)
return ;
self->state = state;
if (state)
gtk_widget_set_state_flags (GTK_WIDGET (self), GTK_STATE_FLAG_CHECKED, FALSE );
else
gtk_widget_unset_state_flags (GTK_WIDGET (self), GTK_STATE_FLAG_CHECKED);
g_object_notify_by_pspec (G_OBJECT (self), switch_props[PROP_STATE]);
}
/**
* gtk_switch_get_state :
* @ self : a ` GtkSwitch `
*
* Gets the underlying state of the ` GtkSwitch ` .
*
* Returns : the underlying state
*/
gboolean
gtk_switch_get_state (GtkSwitch *self)
{
g_return_val_if_fail (GTK_IS_SWITCH (self), FALSE );
return self->state;
}
Messung V0.5 in Prozent C=98 H=96 G=96
¤ Die Informationen auf dieser Webseite wurden
nach bestem Wissen sorgfältig zusammengestellt. Es wird jedoch weder Vollständigkeit, noch Richtigkeit,
noch Qualität der bereit gestellten Informationen zugesichert.0.14Bemerkung:
(vorverarbeitet am 2026-07-03)
¤
*Bot Zugriff