类
GtkSwitch
说明 [src]
final class Gtk.Switch : Gtk.Widget
implements Gtk.Accessible, Gtk.Actionable, Gtk.Buildable, Gtk.ConstraintTarget {
/* No available fields */
}GtkSwitch 是一个拥有开启和关闭两种状态的“轻型开关”。
用户可以通过单击空白区域或者拖动滑块来控制哪个状态应处于活动状态。
GtkSwitch 还可以表示底层状态会延迟更改的情况。在这种情况下，滑块位置指示用户的最近更改（由 GtkSwitch:active 属性表示），而槽的颜色指示当前底层状态（由 GtkSwitch:state 属性表示）。
请参阅 GtkSwitch::state-set 以了解详细信息。
快捷方式和手势
GtkSwitch 支持通过拖动手势来移动滑块。
CSS 节点
switch
├── image
├── image
╰── slider
GtkSwitch 包含四个 css 节点，即带名称 switch 的主节点以及滑块和开启/关闭图像的子节点。其中没有一个使用任何样式类。
辅助功能
GtkSwitch 使用 GTK_ACCESSIBLE_ROLE_SWITCH 角色。
实例方法
从 GtkAccessible（19）继承的方法
gtk_accessible_announce
要求用户屏幕阅读器宣布给定消息。
自：4.14
gtk_accessible_get_accessible_parent
为辅助对象检索辅助父对象。
自：4.10
gtk_accessible_get_accessible_role
检索辅助对象的可访问角色。
gtk_accessible_get_at_context
检索给定辅助对象的方法实现。
自：4.10
gtk_accessible_get_bounds
查询此辅助功能的坐标和尺寸。
自：4.10
gtk_accessible_get_first_accessible_child
检索辅助对象的第一个辅助子对象。
自：4.10
gtk_accessible_get_next_accessible_sibling
检索辅助对象的下一个辅助兄弟对象。
自：4.10
gtk_accessible_get_platform_state
检索平台状态，如焦点。
自：4.10
gtk_accessible_reset_property
将无障碍属性重置为其默认值。
gtk_accessible_reset_relation
将无障碍关系重置为其默认值。
gtk_accessible_reset_state
将无障碍状态重置为其默认值。
gtk_accessible_set_accessible_parent
设置无障碍对象的父级和同级。
自：4.10
gtk_accessible_update_next_accessible_sibling
更新下一个无障碍同级。
自：4.10
gtk_accessible_update_property
更新无障碍属性列表。
gtk_accessible_update_property_value
更新无障碍属性数组。
gtk_accessible_update_relation
更新无障碍关系列表。
gtk_accessible_update_relation_value
更新无障碍关系数组。
gtk_accessible_update_state
更新无障碍状态列表。
gtk_accessible_update_state_value
更新无障碍状态数组。
从 GtkActionable 继承的方法（6）
gtk_actionable_get_action_name
获取 actionable 的操作名称。
gtk_actionable_get_action_target_value
获取 actionable 的当前目标值。
gtk_actionable_set_action_name
指定此窗口小组件应与此关联的操作的名称。
gtk_actionable_set_action_target
设置可操作窗口小组件的目标。
gtk_actionable_set_action_target_value
设置可操作窗口小组件的目标值。
gtk_actionable_set_detailed_action_name
设置可操作窗口小组件的操作名称和关联的字符串目标值。
从 GtkBuildable 继承的方法（1）
属性
从 GtkWidget 继承的属性（34）
Gtk.Widget:can-focus
窗口小组件或其任何子组件是否可以接受输入焦点。
Gtk.Widget:can-target
窗口小组件是否可以接收指针事件。
Gtk.Widget:css-classes
应用于此窗口小组件的 CSS 类列表。
Gtk.Widget:css-name
此窗口小组件在 CSS 树中的名称。
Gtk.Widget:cursor
widget 使用的游标。
Gtk.Widget:focus-on-click
窗口小组件是否应在用户单击鼠标时获取焦点。
Gtk.Widget:focusable
此窗口小组件本身是否会接受输入焦点。
Gtk.Widget:halign
如果窗口小组件获得额外空间，水平空间将如何分配。
Gtk.Widget:has-default
窗口小组件是否为默认窗口小组件。
Gtk.Widget:has-focus
窗口小组件是否具有输入焦点。
Gtk.Widget:has-tooltip
启用或禁用 widget 的 GtkWidget::query-tooltip 信号的发射。
Gtk.Widget:height-request
替换窗口小组件的高度请求。
Gtk.Widget:hexpand
是否水平扩展。
Gtk.Widget:hexpand-set
是否使用 hexpand 属性。
Gtk.Widget:layout-manager
用于计算窗口小组件的首选大小并分配其子组件的 GtkLayoutManager 实例。
Gtk.Widget:margin-bottom
窗口小组件底部的边距。
Gtk.Widget:margin-end
窗口小组件末尾的边距，水平方向。
Gtk.Widget:margin-start
窗口小组件起始处的边距，水平方向。
Gtk.Widget:margin-top
窗口小组件顶部的边距。
Gtk.Widget:name
窗口小组件的名称。
Gtk.Widget:opacity
窗口小组件请求的不透明度。
Gtk.Widget:overflow
如何处理窗口小组件内容区域之外的内容。
Gtk.Widget:parent
此小组件的父小组件。
Gtk.Widget:receives-default
小组件在获取焦点时会否接收默认操作。
Gtk.Widget:root
包含此小组件的小组件树的 GtkRoot 小组件。
Gtk.Widget:scale-factor
小组件的缩放因子。
Gtk.Widget:sensitive
小组件是否会响应输入。
Gtk.Widget:tooltip-markup
将工具提示的文本设置为以 Pango 标记语言标记的给定字符串。
Gtk.Widget:tooltip-text
将工具提示的文本设置为给定的字符串。
Gtk.Widget:valign
如果小组件获取额外空间，如何分配垂直空间。
Gtk.Widget:vexpand
是否垂直展开。
Gtk.Widget:vexpand-set
是否使用 vexpand 属性。
Gtk.Widget:visible
小组件是否可见。
Gtk.Widget:width-request
小组件的宽度请求的重写内容。
从 GtkAccessible （1）继承的属性
从 GtkActionable （2）继承的属性
信号
从 GtkWidget （13）继承的信号
GtkWidget::destroy
发出该信号以表明小组件的所有引用应释放对其持有的引用。
GtkWidget::direction-changed
小组件的文本方向发生更改时发出此信号。
GtkWidget::hide
widget 隐藏时发出此信号。
GtkWidget::keynav-failed
键盘导航失败时发出此信号。
GtkWidget::map
widget 即将映射时发出此信号。
GtkWidget::mnemonic-activate
控件通过助记符激活时发出该信号。
GtkWidget::move-focus
焦点移走时发出此信号。
GtkWidget::query-tooltip
小组件的工具提示即将显示时发出此信号。
GtkWidget::realize
widget 与 GdkSurface 关联时发出此信号。
GtkWidget::show
widget 显示时发出此信号。
GtkWidget::state-flags-changed
小组件的状态发生更改时发出此信号。
GtkWidget::unmap
widget 即将取消映射时发出此信号。
GtkWidget::unrealize
与 widget 关联的 GdkSurface 被销毁时发出此信号。
从 GObject （1）继承的信号
GObject::notify
当对象中的一个属性通过 g_object_set_property()、g_object_set() 等手段设置其值时，便会发出 notify 信号。