类
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
。
构造函数
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 以获取方法的完整列表。
属性
继承自 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:editable
为 TRUE
且单元格为空时,将在 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)继承的信号
继承自 GtkCellRenderer(2)的信号
GtkCellRenderer::editing-canceled
当用户取消编辑单元格的过程时,会发出此信号。例如,可以编写一个可编辑的单元格渲染器,以便在用户按下 “Esc” 时取消编辑。
GtkCellRenderer::editing-started
当开始编辑单元格时,会发出此信号。此信号的预期用途是对 editable
进行特殊设置,例如添加 GtkEntryCompletion
或在 GtkComboBox
中设置额外的列。
继承自 GObject(1)的信号
GObject::notify
在对象其中一个属性的值通过 g_object_set_property()、g_object_set() 等设置时,在对象上发出 notify 信号。