类
GtkCheckButton
说明 [src]
class Gtk.CheckButton : Gtk.Widget
implements Gtk.Accessible, Gtk.Actionable, Gtk.Buildable, Gtk.ConstraintTarget {
/* No available fields */
}GtkCheckButton 将标签放置在指示器旁边。
通过调用 gtk_check_button_new() 或 gtk_check_button_new_with_label() 创建 GtkCheckButton。
GtkCheckButton 的状态可以使用 gtk_check_button_set_active() 专门设置，并可以使用 gtk_check_button_get_active() 获取。
不一致的状态
除了“开”和“关”之外，复选框可以处于既不是开也不是关的“其中间”状态。这可用于选择受复选框影响并且该范围内的当前值不一致的元素（例如一些文本或电子表格单元格）。
要将 GtkCheckButton 设置为不一致的状态，请使用 gtk_check_button_set_inconsistent()。
分组
复选框可以分组在一起，以形成互斥组 - 一次只能切换一个按钮，而切换另一个按钮将切换当前切换的按钮关闭。
分组的复选框使用不同的指示器，通常称为单选按钮。
若要将 GtkCheckButton 添加到组中，请使用 gtk_check_button_set_group()。
当代码必须跟踪一组单选按钮的状态时，建议通过带有每个按钮目标的有状态 GAction 来跟踪此类状态。不建议使用 toggled 信号来跟踪组更改和状态。
快捷键和手势
GtkCheckButton 支持以下键盘快捷键
- ␣ 或 Enter 激活按钮。
CSS 节点
checkbutton[.text-button][.grouped]
├── check
╰── [label]
GtkCheckButton 具有一个名为 checkbutton 的主节点。如果设置 GtkCheckButton:label 或 GtkCheckButton:child 属性，则它包含一个子部件。当没有设置组时，指示符节点被命名为 check，如果复选框与其他复选框组合在一起，则被命名为 radio。
辅助功能
GtkCheckButton 使用 GTK_ACCESSIBLE_ROLE_CHECKBOX 角色。
实例方法
从 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 信号。
类结构
struct GtkCheckButtonClass {
GtkWidgetClass parent_class;
void (* toggled) (
GtkCheckButton* check_button
);
void (* activate) (
GtkCheckButton* check_button
);
}无可用说明。
类成员
parent_class: GtkWidgetClass无可用说明。
toggled: void (* toggled) ( GtkCheckButton* check_button )无可用说明。
activate: void (* activate) ( GtkCheckButton* check_button )无可用说明。