GtkCellRendererText

已弃用:4.10 

描述 [src]

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

在单元格中呈现文本

GtkCellRendererText 使用其属性提供的字体、颜色和样式信息在其单元格中呈现给定的文本。如果文本太长,并且 GtkCellRendererText:ellipsize 属性允许,则文本将被省略。

如果 GtkCellRenderer:modeGTK_CELL_RENDERER_MODE_EDITABLEGtkCellRendererText 允许使用输入项编辑其文本。

弃用时间:4.10

列表视图使用小组件显示其内容。你应该使用 GtkInscriptionGtkLabel 代替。

层次

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

构造函数

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

GObject(43)继承的方法

有关方法的完整列表,请参阅GObject

属性

Gtk.CellRendererText:align-set
无可用描述。

Gtk.CellRendererText:alignment

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

Gtk.CellRendererText:attributes
无可用描述。

Gtk.CellRendererText:background
无可用描述。

Gtk.CellRendererText:background-rgba

背景颜色(作为 GdkRGBA)。

Gtk.CellRendererText:editable
无可用描述。

Gtk.CellRendererText:ellipsize

指定字符串省略的理想位置(如果单元格渲染器没有足够的空间来显示整个字符串)。将其设置为 PANGO_ELLIPSIZE_NONE 会关闭省略。有关使文本适应给定 width 的另一种方法,请参见 wrap-width 属性。

Gtk.CellRendererText:family
无可用描述。

Gtk.CellRendererText:family-set
无可用描述。

Gtk.CellRendererText:font
无可用描述。

Gtk.CellRendererText:font-desc
无可用描述。

Gtk.CellRendererText:foreground
无可用描述。

Gtk.CellRendererText:foreground-rgba

前景颜色(作为 GdkRGBA)。

Gtk.CellRendererText:language
无可用描述。

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:size
无可用描述。

Gtk.CellRendererText:size-set
无可用描述。

Gtk.CellRendererText:stretch
无可用描述。

Gtk.CellRendererText:style
无可用描述。

Gtk.CellRendererText:style-set
无可用描述。

Gtk.CellRendererText:text
无可用描述。

Gtk.CellRendererText:underline
无可用描述。

Gtk.CellRendererText:variant
无可用描述。

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.CellRendererText::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() 以及其他方法设置它的值时,会发出该通知信号。

类结构

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 )

无可用描述。

虚拟方法