GtkCellRendererText

GtkCellRendererText — Отображает текст в ячейке

Функции

GtkCellRenderer *	gtk_cell_renderer_text_new ()
void	gtk_cell_renderer_text_set_fixed_height_from_font ()

Свойства

gboolean	align-set	Чтение / Запись
PangoAlignment	alignment	Чтение / Запись
PangoAttrList *	attributes	Чтение / Запись
gchar *	background	Запись
GdkColor *	background-gdk	Чтение / Запись
GdkRGBA *	background-rgba	Чтение / Запись
gboolean	background-set	Чтение / Запись
gboolean	editable	Чтение / Запись
gboolean	editable-set	Чтение / Запись
PangoEllipsizeMode	ellipsize	Чтение / Запись
gboolean	ellipsize-set	Чтение / Запись
gchar *	family	Чтение / Запись
gboolean	family-set	Чтение / Запись
gchar *	font	Чтение / Запись
PangoFontDescription *	font-desc	Чтение / Запись
gchar *	foreground	Запись
GdkColor *	foreground-gdk	Чтение / Запись
GdkRGBA *	foreground-rgba	Чтение / Запись
gboolean	foreground-set	Чтение / Запись
gchar *	language	Чтение / Запись
gboolean	language-set	Чтение / Запись
gchar *	markup	Запись
gint	max-width-chars	Чтение / Запись
gchar *	placeholder-text	Чтение / Запись
gint	rise	Чтение / Запись
gboolean	rise-set	Чтение / Запись
gdouble	scale	Чтение / Запись
gboolean	scale-set	Чтение / Запись
gboolean	single-paragraph-mode	Чтение / Запись
gint	size	Чтение / Запись
gdouble	size-points	Чтение / Запись
gboolean	size-set	Чтение / Запись

PangoStretch	stretch	Чтение / Запись
gboolean	stretch-set	Чтение / Запись
gboolean	strikethrough	Чтение / Запись
gboolean	strikethrough-set	Чтение / Запись
PangoStyle	style	Чтение / Запись
gboolean	style-set	Чтение / Запись
gchar *	text	Чтение / Запись
PangoUnderline	underline	Чтение / Запись
gboolean	underline-set	Чтение / Запись
PangoVariant	variant	Чтение / Запись
gboolean	variant-set	Чтение / Запись
gint	weight	Чтение / Запись
gboolean	weight-set	Чтение / Запись
gint	width-chars	Чтение / Запись
PangoWrapMode	wrap-mode	Чтение / Запись
gint	wrap-width	Чтение / Запись

Сигналы

void

edited

Выполнить последним

Типы и значения

struct

GtkCellRendererText

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

    GObject
    ╰── GInitiallyUnowned
        ╰── GtkCellRenderer
            ╰── GtkCellRendererText
                ├── GtkCellRendererAccel
                ├── GtkCellRendererCombo
                ╰── GtkCellRendererSpin

Включаемые файлы

#include <gtk/gtk.h>

Описание

A GtkCellRendererText отображает заданный текст в ячейке, используя информацию о шрифте, цвете и стиле, предоставленную его свойствами. Текст будет усечён, если он слишком длинный, и свойство “ellipsize” позволяет это.

Если “mode” равно GTK_CELL_RENDERER_MODE_EDITABLE, 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	A GtkCellRendererText
number_of_rows	Количество строк текста, выделенных для каждого рендерера ячейки, или -1

Типы и значения

struct GtkCellRendererText

struct GtkCellRendererText;

Подробное описание свойств

Свойство `“align-set”`

  “align-set”                gboolean

Определяет, влияет ли данный тег на режим выравнивания.

Флаги: Чтение / Запись

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

Свойство `“alignment”`

  “alignment”                PangoAlignment

Указывает, как выравнивать строки текста друг относительно друга.

Обратите внимание, что данное свойство описывает выравнивание строк текста в случае, если их несколько. Свойство «xalign» объекта GtkCellRenderer, с другой стороны, устанавливает горизонтальное выравнивание всего текста.

Флаги: Чтение / Запись

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

С версии: 2.10

Свойство `“attributes”`

  “attributes”               PangoAttrList *

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

Флаги: Чтение / Запись

Свойство `“background”`

  “background”               gchar *

Цвет фона в виде строки.

Флаги: Запись

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

Свойство `“background-gdk”`

  “background-gdk”           GdkColor *

Цвет фона в виде GdkColor

GtkCellRendererText:background-gdk устарел с версии 3.4 и не должен использоваться в новом коде.

Используйте “background-rgba” вместо него.

Флаги: Чтение / Запись

Свойство `“background-rgba”`

  “background-rgba”          GdkRGBA *

Цвет фона в виде GdkRGBA

Флаги: Чтение / Запись

С версии: 3.0

Свойство `“background-set”`

  “background-set”           gboolean

Определяет, влияет ли данный тег на цвет фона.

Флаги: Чтение / Запись

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

Свойство `“editable”`

  “editable”                 gboolean

Определяет, можно ли пользователю изменить текст.

Флаги: Чтение / Запись

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

Свойство `“editable-set”`

  “editable-set”             gboolean

Определяет, влияет ли данный тег на редактируемость текста.

Флаги: Чтение / Запись

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

Свойство `“ellipsize”`

  “ellipsize”                PangoEllipsizeMode

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

Флаги: Чтение / Запись

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

С версии: 2.6

Свойство `“ellipsize-set”`

  “ellipsize-set”            gboolean

Определяет, влияет ли данный тег на режим обрезки.

Флаги: Чтение / Запись

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

Свойство `“family”`

  “family”                   gchar *

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

Флаги: Чтение / Запись

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

Свойство `“family-set”`

  “family-set”               gboolean

Определяет, влияет ли данный тег на семейство шрифтов.

Флаги: Чтение / Запись

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

Свойство `“font”`

  “font”                     gchar *

Описание шрифта в виде строки, например, "Sans Italic 12".

Флаги: Чтение / Запись

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

Свойство `“font-desc”`

  “font-desc”                PangoFontDescription *

Описание шрифта в виде структуры PangoFontDescription.

Флаги: Чтение / Запись

Свойство `“foreground”`

  “foreground”               gchar *

Цвет текста в виде строки.

Флаги: Запись

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

Свойство `“foreground-gdk”`

  “foreground-gdk”           GdkColor *

Цвет текста в виде GdkColor

GtkCellRendererText:foreground-gdk устарел с версии 3.4 и не должен использоваться в новом коде.

Используйте “foreground-rgba” вместо него.

Флаги: Чтение / Запись

Свойство `“foreground-rgba”`

  “foreground-rgba”          GdkRGBA *

Цвет текста в виде GdkRGBA

Флаги: Чтение / Запись

С версии: 3.0

Свойство `“foreground-set”`

  “foreground-set”           gboolean

Определяет, влияет ли данный тег на цвет текста.

Флаги: Чтение / Запись

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

Свойство `“language”`

  “language”                 gchar *

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

Флаги: Чтение / Запись

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

Свойство `“language-set”`

  “language-set”             gboolean

Определяет, влияет ли данный тег на язык, на котором отображается текст.

Флаги: Чтение / Запись

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

Свойство `“markup”`

  “markup”                   gchar *

Размеченный текст для отображения.

Флаги: Запись

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

Свойство `“max-width-chars”`

  “max-width-chars”          gint

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

Для рендереров ячеек, которые обрезают или обтекают текст; это свойство управляет максимальной заявленной шириной ячейки. Ячейка не должна получать большее выделение, если не настроено расширение в её GtkCellLayout и все ячейки-сестры получили свою естественную ширину.

Флаги: Чтение / Запись

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

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

С версии: 3.0

Свойство `“placeholder-text”`

  “placeholder-text”         gchar *

Текст, который будет отображаться в GtkCellRenderer, если “editable” равен TRUE, и ячейка пуста.

С версии 3.6

Флаги: Чтение / Запись

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

Свойство `“rise”`

  “rise”                     gint

Смещение текста над базовой линией (под базовой линией, если rise отрицательное).

Флаги: Чтение / Запись

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

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

Свойство `“rise-set”`

  “rise-set”                 gboolean

Определяет, влияет ли данный тег на rise.

Флаги: Чтение / Запись

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

Свойство `“scale”`

  “scale”                    gdouble

Коэффициент масштабирования шрифта.

Флаги: Чтение / Запись

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

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

Свойство `“scale-set”`

  “scale-set”                gboolean

Определяет, влияет ли данный тег на масштабирование размера шрифта.

Флаги: Чтение / Запись

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

Свойство `“single-paragraph-mode”`

  “single-paragraph-mode”    gboolean

Определяет, следует ли хранить весь текст в одном абзаце.

Флаги: Чтение / Запись

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

Свойство `“size”`

  “size”                     gint

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

Флаги: Чтение / Запись

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

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

Свойство `“size-points”`

  “size-points”              gdouble

Размер шрифта в пунктах.

Флаги: Чтение / Запись

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

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

Свойство `“size-set”`

  “size-set”                 gboolean

Определяет, влияет ли данный тег на размер шрифта.

Флаги: Чтение / Запись

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

Свойство `“stretch”`

  “stretch”                  PangoStretch

Нажим шрифта.

Флаги: Чтение / Запись

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

Свойство `“stretch-set”`

  “stretch-set”              gboolean

Определяет, влияет ли данный тег на нажим шрифта.

Флаги: Чтение / Запись

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

Свойство `“strikethrough”`

  “strikethrough”            gboolean

Определяет, следует ли прочеркивать текст.

Флаги: Чтение / Запись

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

Свойство `“strikethrough-set”`

  “strikethrough-set”        gboolean

Определяет, влияет ли данный тег на прочеркивание.

Флаги: Чтение / Запись

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

Свойство `“style”`

  “style”                    PangoStyle

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

Флаги: Чтение / Запись

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

Свойство `“style-set”`

  “style-set”                gboolean

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

Флаги: Чтение / Запись

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

Свойство `“text”`

  “text”                     gchar *

Текст для отрисовки.

Флаги: Чтение / Запись

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

Свойство `“underline”`

  “underline”                PangoUnderline

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

Флаги: Чтение / Запись

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

Свойство `“underline-set”`

  “underline-set”            gboolean

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

Флаги: Чтение / Запись

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

Свойство `“variant”`

  “variant”                  PangoVariant

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

Флаги: Чтение / Запись

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

Свойство `“variant-set”`

  “variant-set”              gboolean

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

Флаги: Чтение / Запись

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

Свойство `“weight”`

  “weight”                   gint

Вес шрифта.

Флаги: Чтение / Запись

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

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

Свойство `“weight-set”`

  “weight-set”               gboolean

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

Флаги: Чтение / Запись

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

Свойство `“width-chars”`

  “width-chars”              gint

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

Флаги: Чтение / Запись

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

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

С момента: 2.6

Свойство `“wrap-mode”`

  “wrap-mode”                PangoWrapMode

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

Флаги: Чтение / Запись

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

С момента: 2.8

Свойство `“wrap-width”`

  “wrap-width”               gint

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

Флаги: Чтение / Запись

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

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

С момента: 2.8

Подробное описание сигналов

Сигнал `“edited”`

void
user_function (GtkCellRendererText *renderer,
               gchar               *path,
               gchar               *new_text,
               gpointer             user_data)

Этот сигнал испускается после редактирования renderer.

Приложение отвечает за обновление модели и сохранение new_text в позиции, указанной path.

Параметры

renderer	объект, получивший сигнал
path	путь, определяющий редактируемую ячейку
new_text	новый текст
user_data	пользовательские данные, установленные при подключении обработчика сигналов.

Флаги: Run Last

© 2005–2020 The GNOME Project
Licensed under the GNU Lesser General Public License version 2.1 or later.
https://developer.gnome.org/gtk3/3.22/GtkCellRendererText.html

GtkCellRendererText

Функции

Свойства

Сигналы

Типы и значения

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

Включаемые файлы

Описание

Функции

gtk_cell_renderer_text_new ()

Возвращаемое значение

gtk_cell_renderer_text_set_fixed_height_from_font ()

Параметры

Типы и значения

struct GtkCellRendererText

Подробное описание свойств

Свойство “align-set”

Свойство “alignment”

Свойство “attributes”

Свойство “background”

Свойство “background-gdk”

Свойство “background-rgba”

Свойство “background-set”

Свойство “editable”

Свойство “editable-set”

Свойство “ellipsize”

Свойство “ellipsize-set”

Свойство “family”

Свойство “family-set”

Свойство “font”

Свойство “font-desc”

Свойство “foreground”

Свойство “foreground-gdk”

Свойство “foreground-rgba”

Свойство “foreground-set”

Свойство “language”

Свойство “language-set”

Свойство “markup”

Свойство “max-width-chars”

Свойство “placeholder-text”

Свойство “rise”

Свойство “rise-set”

Свойство “scale”

Свойство “scale-set”

Свойство “single-paragraph-mode”

Свойство “size”

Свойство “size-points”

Свойство “size-set”

Свойство “stretch”

Свойство “stretch-set”

Свойство “strikethrough”

Свойство “strikethrough-set”

Свойство “style”

Свойство “style-set”

Свойство “text”

Свойство “underline”

Свойство “underline-set”

Свойство “variant”

Свойство “variant-set”

Свойство “weight”

Свойство “weight-set”

Свойство “width-chars”

Свойство “wrap-mode”

Свойство “wrap-width”

Подробное описание сигналов

Сигнал “edited”

Параметры

Свойство `“align-set”`

Свойство `“alignment”`

Свойство `“attributes”`

Свойство `“background”`

Свойство `“background-gdk”`

Свойство `“background-rgba”`

Свойство `“background-set”`

Свойство `“editable”`

Свойство `“editable-set”`

Свойство `“ellipsize”`

Свойство `“ellipsize-set”`

Свойство `“family”`

Свойство `“family-set”`

Свойство `“font”`

Свойство `“font-desc”`

Свойство `“foreground”`

Свойство `“foreground-gdk”`

Свойство `“foreground-rgba”`

Свойство `“foreground-set”`

Свойство `“language”`

Свойство `“language-set”`

Свойство `“markup”`

Свойство `“max-width-chars”`

Свойство `“placeholder-text”`

Свойство `“rise”`

Свойство `“rise-set”`

Свойство `“scale”`

Свойство `“scale-set”`

Свойство `“single-paragraph-mode”`

Свойство `“size”`

Свойство `“size-points”`

Свойство `“size-set”`

Свойство `“stretch”`

Свойство `“stretch-set”`

Свойство `“strikethrough”`

Свойство `“strikethrough-set”`

Свойство `“style”`

Свойство `“style-set”`

Свойство `“text”`

Свойство `“underline”`

Свойство `“underline-set”`

Свойство `“variant”`

Свойство `“variant-set”`

Свойство `“weight”`

Свойство `“weight-set”`

Свойство `“width-chars”`

Свойство `“wrap-mode”`

Свойство `“wrap-width”`

Сигнал `“edited”`