类
GtkCellRendererText
已弃用:4.10
描述 [src]
class Gtk.CellRendererText : Gtk.CellRenderer
{
/* No available fields */
}
在单元格中呈现文本
GtkCellRendererText
使用其属性提供的字体、颜色和样式信息在其单元格中呈现给定的文本。如果文本太长,并且 GtkCellRendererText:ellipsize
属性允许,则文本将被省略。
如果 GtkCellRenderer:mode
为 GTK_CELL_RENDERER_MODE_EDITABLE
,GtkCellRendererText
允许使用输入项编辑其文本。
弃用时间:4.10
列表视图使用小组件显示其内容。你应该使用 GtkInscription
或 GtkLabel
代替。
构造函数
gtk_cell_renderer_text_new
创建一个新的 GtkCellRendererText
。通过对象属性调整文本的绘制方式。对象属性可以全局设置(通过 g_object_set())。此外,通过 GtkTreeViewColumn
,你可以将属性绑定到 GtkTreeModel
中的值。例如,你可以将单元格渲染器上的 “text” 属性绑定到模型中的一个字符串值,因此在 GtkTreeView
的每一行中都会呈现一个不同的字符串。
已弃用:4.10
实例方法
gtk_cell_renderer_text_set_fixed_height_from_font
将渲染器的高度设置为显式由其上设置的 “font” 和 “y_pad” 属性决定。这些属性的未来更改不影响高度,因此它们必须与随后对此函数的调用一同使用。使用此函数缺乏灵活性,而且实际上只应在计算单元格大小时太慢(即,显示的海量单元格)时才使用。如果 number_of_rows
为 -1,则固定高度取消设置,高度再次由属性决定。
已弃用:4.10
从 GtkCellRenderer(27)继承的方法
有关方法的完整列表,请参阅 GtkCellRenderer。
属性
Gtk.CellRendererText:ellipsize
指定字符串省略的理想位置(如果单元格渲染器没有足够的空间来显示整个字符串)。将其设置为 PANGO_ELLIPSIZE_NONE
会关闭省略。有关使文本适应给定 width 的另一种方法,请参见 wrap-width 属性。
Gtk.CellRendererText:placeholder-text
如果 GtkCellRendererText:editable
为 TRUE
且单元格为空,则在 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
当用户取消单元格编辑时会发出该信号。例如,当用户按下 Esc 键时,可以编写一个可编辑的单元格渲染器来取消编辑。
GtkCellRenderer::editing-started
当一个单元格开始被编辑时会发出该信号。该信号的预期用法是对 editable
做特殊设置,例如添加一个 GtkEntryCompletion
或在 GtkComboBox
中设置附加的列。
继承自 GObject 的信号 (1)
GObject::notify
当一个对象的属性通过 g_object_set_property()、g_object_set() 以及其他方法设置它的值时,会发出该通知信号。
类结构
struct GtkCellRendererTextClass {
GtkCellRendererClass parent_class;
void (* edited) (
GtkCellRendererText* cell_renderer_text,
const char* path,
const char* new_text
);
}
无可用描述。
类成员
父类:GtkCellRendererClass
无可用描述。
edited: void (* edited) ( GtkCellRendererText* cell_renderer_text, const char* path, const char* new_text )
无可用描述。