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	Чтение / Запись
char *	background	Запись
GdkRGBA *	background-rgba	Чтение / Запись
gboolean	background-set	Чтение / Запись
gboolean	editable	Чтение / Запись
gboolean	editable-set	Чтение / Запись
PangoEllipsizeMode	ellipsize	Чтение / Запись
gboolean	ellipsize-set	Чтение / Запись
char *	family	Чтение / Запись
gboolean	family-set	Чтение / Запись
char *	font	Чтение / Запись
PangoFontDescription *	font-desc	Чтение / Запись
char *	foreground	Запись
GdkRGBA *	foreground-rgba	Чтение / Запись
gboolean	foreground-set	Чтение / Запись
char *	language	Чтение / Запись
gboolean	language-set	Чтение / Запись
char *	markup	Запись
int	max-width-chars	Чтение / Запись
char *	placeholder-text	Чтение / Запись
int	rise	Чтение / Запись
gboolean	rise-set	Чтение / Запись
double	scale	Чтение / Запись
gboolean	scale-set	Чтение / Запись
gboolean	single-paragraph-mode	Чтение / Запись
int	size	Чтение / Запись
double	size-points	Чтение / Запись
gboolean	size-set	Чтение / Запись
PangoStretch	stretch	Чтение / Запись
gboolean	stretch-set	Чтение / Запись
gboolean	strikethrough	Чтение / Запись
gboolean	strikethrough-set	Чтение / Запись
PangoStyle	style	Чтение / Запись
gboolean	style-set	Чтение / Запись
char *	text	Чтение / Запись
PangoUnderline	underline	Чтение / Запись
gboolean	underline-set	Чтение / Запись
PangoVariant	variant	Чтение / Запись
gboolean	variant-set	Чтение / Запись
int	weight	Чтение / Запись
gboolean	weight-set	Чтение / Запись
int	width-chars	Чтение / Запись
PangoWrapMode	wrap-mode	Чтение / Запись
int	wrap-width	Чтение / Запись

Сигналы

void

edited

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

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

struct

GtkCellRendererText

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

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

Файлы заголовков

#include <gtk/gtk.h>

Описание

Отображает заданный текст в ячейке, используя шрифт, цвет и стили, заданные в свойствах. Текст будет обрезаться, если он слишком длинный, и свойство “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,
                                int 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

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

Владелец: GtkCellRendererText

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

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

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

  “alignment”                PangoAlignment

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

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

Владелец: GtkCellRendererText

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

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

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

  “attributes”               PangoAttrList *

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

Владелец: GtkCellRendererText

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

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

  “background”               char *

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

Владелец: GtkCellRendererText

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

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

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

  “background-rgba”          GdkRGBA *

Цвет фона как GdkRGBA

Владелец: GtkCellRendererText

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

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

  “background-set”           gboolean

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

Владелец: GtkCellRendererText

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

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

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

  “editable”                 gboolean

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

Владелец: GtkCellRendererText

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

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

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

  “editable-set”             gboolean

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

Владелец: GtkCellRendererText

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

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

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

  “ellipsize”                PangoEllipsizeMode

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

Владелец: GtkCellRendererText

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

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

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

  “ellipsize-set”            gboolean

Влияет ли этот тег на режим многоточия.

Владелец: GtkCellRendererText

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

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

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

  “family”                   char *

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

Владелец: GtkCellRendererText

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

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

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

  “family-set”               gboolean

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

Владелец: GtkCellRendererText

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

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

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

  “font”                     char *

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

Владелец: GtkCellRendererText

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

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

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

  “font-desc”                PangoFontDescription *

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

Владелец: GtkCellRendererText

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

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

  “foreground”               char *

Цвет переднего плана в виде строки.

Владелец: GtkCellRendererText

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

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

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

  “foreground-rgba”          GdkRGBA *

Цвет переднего плана как GdkRGBA

Владелец: GtkCellRendererText

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

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

  “foreground-set”           gboolean

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

Владелец: GtkCellRendererText

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

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

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

  “language”                 char *

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

Владелец: GtkCellRendererText

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

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

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

  “language-set”             gboolean

Влияет ли этот тег на язык, на котором отображается текст.

Владелец: GtkCellRendererText

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

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

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

  “markup”                   char *

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

Владелец: GtkCellRendererText

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

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

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

  “max-width-chars”          int

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

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

Владелец: GtkCellRendererText

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

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

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

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

  “placeholder-text”         char *

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

Владелец: GtkCellRendererText

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

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

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

  “rise”                     int

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

Владелец: GtkCellRendererText

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

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

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

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

  “rise-set”                 gboolean

Влияет ли этот тег на rise.

Владелец: GtkCellRendererText

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

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

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

  “scale”                    double

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

Владелец: GtkCellRendererText

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

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

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

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

  “scale-set”                gboolean

Масштабирует ли этот тег размер шрифта на коэффициент.

Владелец: GtkCellRendererText

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

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

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

  “single-paragraph-mode”    gboolean

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

Владелец: GtkCellRendererText

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

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

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

  “size”                     int

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

Владелец: GtkCellRendererText

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

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

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

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

  “size-points”              double

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

Владелец: GtkCellRendererText

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

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

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

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

  “size-set”                 gboolean

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

Владелец: GtkCellRendererText

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

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

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

  “stretch”                  PangoStretch

Растяжение шрифта.

Владелец: GtkCellRendererText

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

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

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

  “stretch-set”              gboolean

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

Владелец: GtkCellRendererText

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

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

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

  “strikethrough”            gboolean

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

Владелец: GtkCellRendererText

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

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

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

  “strikethrough-set”        gboolean

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

Владелец: GtkCellRendererText

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

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

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

  “style”                    PangoStyle

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

Владелец: GtkCellRendererText

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

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

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

  “style-set”                gboolean

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

Владелец: GtkCellRendererText

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

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

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

  “text”                     char *

Текст для отображения.

Владелец: GtkCellRendererText

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

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

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

  “underline”                PangoUnderline

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

Владелец: GtkCellRendererText

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

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

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

  “underline-set”            gboolean

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

Владелец: GtkCellRendererText

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

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

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

  “variant”                  PangoVariant

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

Владелец: GtkCellRendererText

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

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

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

  “variant-set”              gboolean

Определяет, влияет ли этот тег на вариант шрифта.

Владелец: GtkCellRendererText

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

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

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

  “weight”                   int

Вес шрифта.

Владелец: GtkCellRendererText

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

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

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

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

  “weight-set”               gboolean

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

Владелец: GtkCellRendererText

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

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

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

  “width-chars”              int

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

Владелец: GtkCellRendererText

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

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

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

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

  “wrap-mode”                PangoWrapMode

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

Владелец: GtkCellRendererText

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

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

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

  “wrap-width”               int

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

Владелец: GtkCellRendererText

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

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

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

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

Сигнал `“edited”`

void
user_function (GtkCellRendererText *renderer,
               char                *path,
               char                *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-old.gnome.org/gtk4/4.0/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-rgba”

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

Свойство “editable”

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

Свойство “ellipsize”

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

Свойство “family”

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

Свойство “font”

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

Свойство “foreground”

Свойство “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-rgba”`

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

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

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

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

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

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

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

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

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

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

Свойство `“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”`