类
GtkCellRendererToggle
已弃用:4.10
说明 [源代码]
final class Gtk.CellRendererToggle : Gtk.CellRenderer
{
/* No available fields */
}
在单元格中渲染一个切换按钮
GtkCellRendererToggle
在单元格中渲染一个切换按钮。根据 GtkCellRendererToggle:radio
属性,按钮绘制为无线电按钮或复选框。激活时,它会发出 GtkCellRendererToggle::toggled
信号。
自 4.10 起弃用
列表视图使用窗口小部件来显示其内容。你应该使用 GtkToggleButton
。
构造方法
gtk_cell_renderer_toggle_new
创建新的 GtkCellRendererToggle
。使用对象属性调整呈现参数。对象属性可以在全局范围内设置(使用 g_object_set())。此外,借助 GtkTreeViewColumn
,你可以将属性绑定到 GtkTreeModel
中的值。例如,你可以将单元格渲染器上的“active”属性绑定到模型中的布尔值,从而导致复选框反映模型的状态。
已弃用:4.10
实例方法
gtk_cell_renderer_toggle_get_activatable
返回单元格渲染器是否可激活。请参阅 gtk_cell_renderer_toggle_set_activatable()。
已弃用:4.10
gtk_cell_renderer_toggle_get_active
返回单元格渲染器是否已激活。请参阅 gtk_cell_renderer_toggle_set_active()。
已弃用:4.10
gtk_cell_renderer_toggle_set_radio
如果 radio
为 TRUE
,单元格渲染器会呈现一个无线电切换(即互斥切换组中的一个切换)。如果为 FALSE
,它会呈现一个复选框(一个独立的布尔选项)。这可以针对单元格的渲染器进行全局设置,或者只在模型中呈现每个单元格之前进行更改(对于 GtkTreeView
,你可以使用 GtkTreeViewColumn
设置按行设置,将模型列与单元格的渲染器属性关联)。
已弃用:4.10
从 GtkCellRenderer 继承的方法 (27)
请参见 GtkCellRenderer 以获得完整的方法列表。
属性
从 GtkCellRenderer 继承的属性(15)
Gtk.CellRenderer:cell-background
Gtk.CellRenderer:cell-background-rgba
作为 GdkRGBA
的单元格背景。
Gtk.CellRenderer:cell-background-set
Gtk.CellRenderer:editing
Gtk.CellRenderer:height
Gtk.CellRenderer:is-expanded
Gtk.CellRenderer:is-expander
Gtk.CellRenderer:mode
Gtk.CellRenderer:sensitive
Gtk.CellRenderer:visible
Gtk.CellRenderer:width
Gtk.CellRenderer:xalign
Gtk.CellRenderer:xpad
Gtk.CellRenderer:yalign
Gtk.CellRenderer:ypad
信号
从 GtkCellRenderer 继承的信号(2)
GtkCellRenderer::editing-canceled
当用户取消编辑单元格过程时,将触发此信号。例如,可以编写一个可编辑的单元格渲染器,当用户按 Escape 时取消编辑。
GtkCellRenderer::editing-started
当开始编辑单元格时,将触发此信号。此信号的预期用途是在 editable
上执行特殊设置,例如添加 GtkEntryCompletion
或在 GtkComboBox
中设置其他列。
从 GObject 继承的信号(1)
GObject::notify
当对象的某个属性通过 g_object_set_property()、g_object_set() 等设置其值时,将会触发 notify 信号。