Prev

Up

Home

GTK+ Reference Manual

Next

Top  |  Description  |  Object Hierarchy  |  Properties  |  Signals

GtkCellRendererText

GtkCellRendererText Представляет текст в ячейке

Краткое описание

#include <gtk/gtk.h> GtkCellRendererText; GtkCellRenderer* gtk_cell_renderer_text_new (void); void gtk_cell_renderer_text_set_fixed_height_from_font (GtkCellRendererText *renderer, gint number_of_rows);

Иерархия объектов

GObject +----GInitiallyUnowned +----GtkObject +----GtkCellRenderer +----GtkCellRendererText +----GtkCellRendererAccel +----GtkCellRendererCombo +----GtkCellRendererSpin

Свойства

"align-set" gboolean : Read / Write "alignment" PangoAlignment : Read / Write "attributes" PangoAttrList : Read / Write "background" gchararray : Write "background-gdk" GdkColor : Read / Write "background-set" gboolean : Read / Write "editable" gboolean : Read / Write "editable-set" gboolean : Read / Write "ellipsize" PangoEllipsizeMode : Read / Write "ellipsize-set" gboolean : Read / Write "family" gchararray : Read / Write "family-set" gboolean : Read / Write "font" gchararray : Read / Write "font-desc" PangoFontDescription : Read / Write "foreground" gchararray : Write "foreground-gdk" GdkColor : Read / Write "foreground-set" gboolean : Read / Write "language" gchararray : Read / Write "language-set" gboolean : Read / Write "markup" gchararray : Write "rise" gint : Read / Write "rise-set" gboolean : Read / Write "scale" gdouble : Read / Write "scale-set" gboolean : Read / Write "single-paragraph-mode" gboolean : Read / Write "size" gint : Read / Write "size-points" gdouble : Read / Write "size-set" gboolean : Read / Write "stretch" PangoStretch : Read / Write "stretch-set" gboolean : Read / Write "strikethrough" gboolean : Read / Write "strikethrough-set" gboolean : Read / Write "style" PangoStyle : Read / Write "style-set" gboolean : Read / Write "text" gchararray : Read / Write "underline" PangoUnderline : Read / Write "underline-set" gboolean : Read / Write "variant" PangoVariant : Read / Write "variant-set" gboolean : Read / Write "weight" gint : Read / Write "weight-set" gboolean : Read / Write "width-chars" gint : Read / Write "wrap-mode" PangoWrapMode : Read / Write "wrap-width" gint : Read / Write

Сигналы

"edited" void user_function (GtkCellRendererText *cellrenderertext, gchar *arg1, gchar *arg2, gpointer user_data) : Run last

Описание

GtkCellRendererText представляет полученный текст в ячейке, использует шрифт, цвет и стиль установленные свойствами. Текст будет дополняемым (ellipsized) если он слишком длинный и ellipsize свойство позволяет это.

Если mode равен GTK_CELL_RENDERER_MODE_EDITABLE, GtkCellRendererText позволяет редактировать текст используя ввод.

Детали

GtkCellRendererText

typedef struct _GtkCellRendererText GtkCellRendererText;

gtk_cell_renderer_text_new ()

GtkCellRenderer* gtk_cell_renderer_text_new (void);

Создаёт новый GtkCellRendererText. Регулирует изображение текста используя свойства объекта. Свойства объекта могут быть установлены глобально (с помощью g_object_set()). Кроме того, с помощью GtkTreeViewColumn, вы можете привязать свойство к значению в GtkTreeModel. Например, вы можете свойство "text" ячейки представления привязать к значению строки в модели, таким образом представляя разные строки в каждой строке GtkTreeView

Возвращает :

Новая ячейка представления


gtk_cell_renderer_text_set_fixed_height_from_font ()

void gtk_cell_renderer_text_set_fixed_height_from_font (GtkCellRendererText *renderer, gint number_of_rows);

Устанавливает высоту представления явно определяя свойства "font" и "y_pad". Дальнейшие изменения этих свойств не влияют на высоту, поэтому они должны сопровождаться повторным вызовом этой функции. Использование этой функции неудобно и должно в действительности применяется только для очень медленного расчета размера ячейки (то есть, массивное число отображаемых ячеек). Если number_of_rows равен -1, то фиксированная высота не установлена, а высота определяется снова свойствами.

renderer :

GtkCellRendererText

number_of_rows :

Количество строк текста каждой ячейки представления, или -1

Детали свойств

Свойство "align-set"

  "align-set"            gboolean              : Read / Write

Влияет ли тег на режим выравнивания.

Значение по умолчанию: FALSE


Свойство "alignment"

  "alignment"            PangoAlignment        : Read / Write

Определяет как выравниваются строки текста.

Значение по умолчанию: PANGO_ALIGN_LEFT

Начиная с версии 2.10


Свойство "attributes"

  "attributes"           PangoAttrList         : Read / Write

Список атрибутов стиля применяемых к представляемому тексту.


Свойство "background"

  "background"           gchararray            : Write

Цвет фона представленный как строка.

Значение по умолчанию: NULL


Свойство "background-gdk"

  "background-gdk"       GdkColor              : Read / Write

Цвет фона как GdkColor.


Свойство "background-set"

  "background-set"       gboolean              : Read / Write

Влияет ли тег на цвет фона.

Значение по умолчанию: FALSE


Свойство "editable"

  "editable"             gboolean              : Read / Write

Может ли текст изменяться пользователем.

Значение по умолчанию: FALSE


Свойство "editable-set"

  "editable-set"         gboolean              : Read / Write

Влияет ли тег на редактируемость текста.

Значение по умолчанию: FALSE


Свойство "ellipsize"

  "ellipsize"            PangoEllipsizeMode    : Read / Write

Определяет привилегированное пространство для дополняющей строки, если ячейка представления не имеет достаточно пространства для отображения всей строки. Установка этого свойства в PANGO_ELLIPSIZE_NONE выключает дополнение. Смотрите свойство wrap-width для другого способа создания текста вписанного в заданную ширину.

Значение по умолчанию: PANGO_ELLIPSIZE_NONE

Начиная с версии 2.6


Свойство "ellipsize-set"

  "ellipsize-set"        gboolean              : Read / Write

Влияет ли тег на режим дополнения (ellipsize mode).

Значение по умолчанию: FALSE


Свойство "family"

  "family"               gchararray            : Read / Write

Имя семейства шрифта, например Sans, Helvetica, Times, Monospace.

Значение по умолчанию: NULL


Свойство "family-set"

  "family-set"           gboolean              : Read / Write

Влияет ли тег на имя шрифта.

Значение по умолчанию: FALSE


Свойство "font"

  "font"                 gchararray            : Read / Write

Шрифт описанный строкой, например "Sans Italic 12".

Значение по умолчанию: NULL


Свойство "font-desc"

  "font-desc"            PangoFontDescription  : Read / Write

Шрифт описанный как структура PangoFontDescription.


Свойство "foreground"

  "foreground"           gchararray            : Write

Цвет символов как строка.

Значение по умолчанию: NULL


Свойство "foreground-gdk"

  "foreground-gdk"       GdkColor              : Read / Write

Цвет символов как GdkColor.


Свойство "foreground-set"

  "foreground-set"       gboolean              : Read / Write

Влияет ли тег на цвет символов.

Значение по умолчанию: FALSE


Свойство "language"

  "language"             gchararray            : Read / Write

Язык этого текста, как код ISO. Pango может использовать это как подсказку при представлении текста. Если вы не понимаете этот параметр, вы вероятно не нуждаетесь в нем.

Значение по умолчанию: NULL


Свойство "language-set"

  "language-set"         gboolean              : Read / Write

Влияет ли тег на язык представляемого текста.

Значение по умолчанию: FALSE


Свойство "markup"

  "markup"               gchararray            : Write

Разметка текста для представления.

Значение по умолчанию: NULL


Свойство "rise"

  "rise"                 gint                  : Read / Write

Смещение текста выше основной линии (ниже основной линии, если rise это отрицательное).

Допустимые значения: >= -2147483647

Значение по умолчанию: 0


Свойство "rise-set"

  "rise-set"             gboolean              : Read / Write

Влияет ли тег на повышение.

Значение по умолчанию: FALSE


Свойство "scale"

  "scale"                gdouble               : Read / Write

Масштабирующий фактор шрифта.

Допустимые значения: >= 0

Значение по умолчанию: 1


Свойство "scale-set"

  "scale-set"            gboolean              : Read / Write

Влияет ли тег на фактор масштабирования шрифта.

Значение по умолчанию: FALSE


Свойство "single-paragraph-mode"

  "single-paragraph-mode" gboolean              : Read / Write

Сохранять ли весь текст в единственном параграфе.

Значение по умолчанию: FALSE


Свойство "size"

  "size"                 gint                  : Read / Write

Размер шрифта.

Допустимые значения: >= 0

Значение по умолчанию: 0


Свойство "size-points"

  "size-points"          gdouble               : Read / Write

Размер шрифта в точках.

Допустимые значения: >= 0

Значение по умолчанию: 0


Свойство "size-set"

  "size-set"             gboolean              : Read / Write

Влияет ли тег на размер шрифта.

Значение по умолчанию: FALSE


Свойство "stretch"

  "stretch"              PangoStretch          : Read / Write

Наклон шрифта.

Значение по умолчанию: PANGO_STRETCH_NORMAL


Свойство "stretch-set"

  "stretch-set"          gboolean              : Read / Write

Влияет ли тег на наклон шрифта.

Значение по умолчанию: FALSE


Свойство "strikethrough"

  "strikethrough"        gboolean              : Read / Write

Перечеркивается ли текст.

Значение по умолчанию: FALSE


Свойство "strikethrough-set"

  "strikethrough-set"    gboolean              : Read / Write

Влияет ли тег на перечеркивание текста.

Значение по умолчанию: FALSE


Свойство "style"

  "style"                PangoStyle            : Read / Write

Стиль шрифта.

Значение по умолчанию: PANGO_STYLE_NORMAL


Свойство "style-set"

  "style-set"            gboolean              : Read / Write

Влияет ли тег на стиль шрифта.

Значение по умолчанию: FALSE


Свойство "text"

  "text"                 gchararray            : Read / Write

Представляемый текст.

Значение по умолчанию: NULL


Свойство "underline"

  "underline"            PangoUnderline        : Read / Write

Стиль подчеркивания этого текста.

Значение по умолчанию: PANGO_UNDERLINE_NONE


Свойство "underline-set"

  "underline-set"        gboolean              : Read / Write

Влияет ли тег на подчеркивание текста.

Значение по умолчанию: FALSE


Свойство "variant"

  "variant"              PangoVariant          : Read / Write

Дополнительный шрифт.

Значение по умолчанию: PANGO_VARIANT_NORMAL


Свойство "variant-set"

  "variant-set"          gboolean              : Read / Write

Влияет ли тег на дополнительный шрифт.

Значение по умолчанию: FALSE


Свойство "weight"

  "weight"               gint                  : Read / Write

Ширина шрифта.

Допустимые значения: >= 0

Значение по умолчанию: 400


Свойство "weight-set"

  "weight-set"           gboolean              : Read / Write

Влияет ли тег на ширину шрифта.

Значение по умолчанию: FALSE


Свойство "width-chars"

  "width-chars"          gint                  : Read / Write

Желательная ширина ячейки, в символах. Если это свойство установлено в -1, ширина будет рассчитана автоматически, иначе ячейка будет запрашивать или 3 символа или значение свойства, в зависимости от того что больше.

Допустимые значения: >= -1

Значение по умолчанию: -1

Начиная с версии 2.6


Свойство "wrap-mode"

  "wrap-mode"            PangoWrapMode         : Read / Write

Определяет как прервать строку, если ячейка представления не может отобразить её всю. Это свойство не имеет значения если не установлено свойство wrap-width.

Значение по умолчанию: PANGO_WRAP_CHAR

Начиная с версии 2.8


Свойство "wrap-width"

  "wrap-width"           gint                  : Read / Write

Определяет ширину оболочки текста. Свойство wrap-mode может использоваться для влияния на символьную позицию размещения прерывания строки. Установка wrap-width в -1 выключает оболочку.

Допустимые значения: >= -1

Значение по умолчанию: -1

Начиная с версии 2.8

Детали сигнала

Сигнал "edited"

void user_function (GtkCellRendererText *cellrenderertext, gchar *arg1, gchar *arg2, gpointer user_data) : Run last

cellrenderertext :

Объект получающий сигнал.

arg1 :

arg2 :

user_data :

Пользовательские данные помещаемые при подключении обработчика сигнала.