GtkCellRendererCombo

弃用:4.10 

描述 [src]

final class Gtk.CellRendererCombo : Gtk.CellRendererText
{
  /* No available fields */
}

在单元格中渲染组合框

GtkCellRendererCombo 在其派生的 GtkCellRendererText 中以文本形式渲染单元格。但 GtkCellRendererText 提供一个简单条目来编辑文本,而 GtkCellRendererCombo 提供一个 GtkComboBox 小部件来编辑文本。组合框中显示的值来自在 GtkCellRendererCombo:model 属性中指定的树模型。

组合单元格渲染器负责向组合框添加一个文本单元格渲染器,并将其设置为显示其 GtkCellRendererCombo:text-column 属性指定的列。可以在 GtkCellRenderer::editing-started 信号的处理程序中设置组合框的更多属性。

自 4.10 版起弃用

列表视图使用小部件显示其内容。您应该改用 GtkDropDown 。

层级

hierarchy this GtkCellRendererCombo ancestor_0 GtkCellRendererText ancestor_0--this ancestor_1 GtkCellRenderer ancestor_1--ancestor_0 ancestor_2 GInitiallyUnowned ancestor_2--ancestor_1 ancestor_3 GObject ancestor_3--ancestor_2

构造函数

gtk_cell_renderer_combo_new

创建一个新的 GtkCellRendererCombo。使用对象属性调整文本的绘制方式。对象属性可以全局设置(使用 g_object_set())。此外,使用 GtkTreeViewColumn,可以将属性绑定到 GtkTreeModel 中的值。例如,你可以将单元格渲染器上的“文本”属性绑定到模型中的字符串值,从而在 GtkTreeView 的每一行中渲染不同的字符串。

弃用:4.10 

实例方法

继承自 GtkCellRendererText 的方法(1)
gtk_cell_renderer_text_set_fixed_height_from_font

设置渲染器的高度,以便明确由其上设置的“字体”和“y_pad”属性决定。这些属性的进一步更改不会影响高度,因此它们必须伴随着对该函数的后继调用。使用此函数不灵活,实际上只能在单元格大小的计算太慢时使用(即,显示大量单元格)。如果 number_of_rows 为 -1,那么固定高度将取消设置,并且高度将再次由属性决定。

弃用:4.10 

继承自 GtkCellRenderer 的方法(27)

请参阅 GtkCellRenderer 以获取方法的完整列表。

继承自 GObject 的方法(43)

请参阅 GObject 以获取方法的完整列表。

属性

Gtk.CellRendererCombo:has-entry

如果为 TRUE,单元格渲染器将包含一个条目,并允许输入弹出列表中之外的值。

Gtk.CellRendererCombo:model

保存一个包含组合框可能值树模型。使用 text_column 属性指定保存值的列。

Gtk.CellRendererCombo:text-column

指定包含组合框可能值的模型列。

继承自 GtkCellRendererText 的属性(46)
Gtk.CellRendererText:align-set
暂无描述。

Gtk.CellRendererText:alignment

指定如何将文本行相互对齐。

Gtk.CellRendererText:attributes
暂无描述。

Gtk.CellRendererText:background
暂无描述。

Gtk.CellRendererText:background-rgba

背景色为GdkRGBA

Gtk.CellRendererText:background-set
暂无描述。

Gtk.CellRendererText:editable
暂无描述。

Gtk.CellRendererText:editable-set
暂无描述。

Gtk.CellRendererText:ellipsize

指定在单元格渲染器没有足够的房间显示全部字符串时,省略号化字符串的首选位置。将其设置为 PANGO_ELLIPSIZE_NONE 会关闭省略号化。请参阅 wrap-width 属性以了解另一种方法,即使文本适应给定的宽度。

Gtk.CellRendererText:ellipsize-set
暂无描述。

Gtk.CellRendererText:family
暂无描述。

Gtk.CellRendererText:family-set
暂无描述。

Gtk.CellRendererText:font
暂无描述。

Gtk.CellRendererText:font-desc
暂无描述。

Gtk.CellRendererText:foreground
暂无描述。

Gtk.CellRendererText:foreground-rgba

前景颜色为 GdkRGBA

Gtk.CellRendererText:foreground-set
暂无描述。

Gtk.CellRendererText:language
暂无描述。

Gtk.CellRendererText:language-set
暂无描述。

Gtk.CellRendererText:markup
暂无描述。

Gtk.CellRendererText:max-width-chars

单元格的最大宽度(以字符为单位)。如果将此属性设置为 -1,宽度会自动计算。

Gtk.CellRendererText:placeholder-text

如果 GtkCellRendererText:editableTRUE 且单元格为空时,将在 GtkCellRenderer 中显示的文本。

Gtk.CellRendererText:rise
暂无描述。

Gtk.CellRendererText:rise-set
暂无描述。

Gtk.CellRendererText:scale
暂无描述。

Gtk.CellRendererText:scale-set
暂无描述。

Gtk.CellRendererText:single-paragraph-mode
暂无描述。

Gtk.CellRendererText:size
暂无描述。

Gtk.CellRendererText:size-points
暂无描述。

Gtk.CellRendererText:size-set
暂无描述。

Gtk.CellRendererText:stretch
暂无描述。

Gtk.CellRendererText:stretch-set
暂无描述。

Gtk.CellRendererText:strikethrough
暂无描述。

Gtk.CellRendererText:strikethrough-set
暂无描述。

Gtk.CellRendererText:style
暂无描述。

Gtk.CellRendererText:style-set
暂无描述。

Gtk.CellRendererText:text
暂无描述。

Gtk.CellRendererText:underline
暂无描述。

Gtk.CellRendererText:underline-set
暂无描述。

Gtk.CellRendererText:variant
暂无描述。

Gtk.CellRendererText:variant-set
暂无描述。

Gtk.CellRendererText:weight
暂无描述。

Gtk.CellRendererText:weight-set
暂无描述。

Gtk.CellRendererText:width-chars

单元格的期望宽度(以字符为单位)。如果将此属性设置为 -1,宽度会自动计算,否则,单元格将请求 3 个字符或属性值,以较大者为准。

Gtk.CellRendererText:wrap-mode

指定在单元格渲染器没有足够的房间显示全部字符串时,如何将字符串拆分为多行。除非设置 wrap-width 属性,否则此属性不会产生影响。

Gtk.CellRendererText:wrap-width

指定文本换行的最窄宽度。可使用 wrap-mode 属性影响在哪些字符位置放置换行符。将 wrap-width 设置为 -1 会关闭换行。

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
暂无描述。

信号

Gtk.CellRendererCombo::changed

每次用户使用鼠标或箭头键在下拉框中选择项目后,都会发出此信号。与 GtkComboBox 相反,不会针对条目在输入中做出的更改发出 GtkCellRendererCombo::changed。参数 new_iter 对应于下拉框中新选中的条目,它相对于通过 GtkCellRendererCombo 上的 model 属性设置的 GtkTreeModel。

GtkCellRendererText(1)继承的信号
GtkCellRendererText::edited

renderer 已编辑之后发出此信号。

继承自 GtkCellRenderer(2)的信号
GtkCellRenderer::editing-canceled

当用户取消编辑单元格的过程时,会发出此信号。例如,可以编写一个可编辑的单元格渲染器,以便在用户按下 “Esc” 时取消编辑。

GtkCellRenderer::editing-started

当开始编辑单元格时,会发出此信号。此信号的预期用途是对 editable 进行特殊设置,例如添加 GtkEntryCompletion 或在 GtkComboBox 中设置额外的列。

继承自 GObject(1)的信号
GObject::notify

在对象其中一个属性的值通过 g_object_set_property()、g_object_set() 等设置时,在对象上发出 notify 信号。