GtkCellRendererText
GtkCellRendererText — Отображает текст в ячейке
Функции
Свойства
| gboolean | align-set | Чтение / Запись |
| PangoAlignment | alignment | Чтение / Запись |
| PangoAttrList * | attributes | Чтение / Запись |
| char * | background | Запись |
| GdkColor * | background-gdk | Чтение / Запись |
| 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 | Запись |
| GdkColor * | foreground-gdk | Чтение / Запись |
| 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 | подчёркивание | Чтение / Запись |
| gboolean | подчёркивание-установлено | Чтение / Запись |
| PangoVariant | вариант | Чтение / Запись |
| gboolean | вариант-установлен | Чтение / Запись |
| int | вес | Чтение / Запись |
| gboolean | вес-установлен | Чтение / Запись |
| int | ширина-символов | Чтение / Запись |
| PangoWrapMode | режим-переноса | Чтение / Запись |
| int | ширина-переноса | Чтение / Запись |
Сигналы
| void | изменён | Последний запуск |
Типы и значения
| struct | GtkCellRendererText |
Иерархия объектов
GObject
╰── GInitiallyUnowned
╰── GtkCellRenderer
╰── GtkCellRendererText
├── GtkCellRendererAccel
├── GtkCellRendererCombo
╰── GtkCellRendererSpin
Файлы
#include <gtk/gtk.h>
Описание
Объект 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 | Объект 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
С версии: 2.10
Свойство “attributes”
“attributes” PangoAttrList *
Список атрибутов стиля, которые необходимо применить к тексту в рендерере.
Владелец: GtkCellRendererText
Флаги: Чтение / Запись
Свойство “background”
“background” char *
Цвет фона в виде строки.
Владелец: GtkCellRendererText
Флаги: Запись
Значение по умолчанию: NULL
Свойство “background-gdk”
“background-gdk” GdkColor *
Цвет фона в виде GdkColor
GtkCellRendererText:background-gdk устарело с версии 3.4 и не должно использоваться в новом коде.
Используйте “background-rgba” вместо него.
Владелец: GtkCellRendererText
Флаги: Чтение / Запись
Свойство “background-rgba”
“background-rgba” GdkRGBA *
Цвет фона в виде GdkRGBA
Владелец: GtkCellRendererText
Флаги: Чтение / Запись
С версии: 3.0
Свойство “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
С версии: 2.6
Свойство “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-gdk”
“foreground-gdk” GdkColor *
Цвет переднего плана в виде GdkColor
GtkCellRendererText:foreground-gdk устарело с версии 3.4 и не должно использоваться в новом коде.
Используйте “foreground-rgba” вместо него.
Владелец: GtkCellRendererText
Флаги: Чтение / Запись
Свойство “foreground-rgba”
“foreground-rgba” GdkRGBA *
Цвет переднего плана в виде GdkRGBA
Владелец: GtkCellRendererText
Флаги: Чтение / Запись
С версии: 3.0
Свойство “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
С версии: 3.0
Свойство “placeholder-text”
“placeholder-text” char *
Текст, который будет отображаться в GtkCellRenderer, если “editable” имеет значение TRUE и ячейка пуста.
С версии 3.6
Владелец: GtkCellRendererText
Флаги: Чтение / Запись
Значение по умолчанию: NULL
Свойство “rise”
“rise” int
Смещение текста над базовой линией (под базовой линией, если rise отрицательный).
Владелец: GtkCellRendererText
Флаги: Чтение / Запись
Допустимые значения: >= -2147483647
Значение по умолчанию: 0
Свойство “rise-set”
“rise-set” gboolean
Указывает, влияет ли данный тег на смещение.
Владелец: 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
С момента: 2.6
Свойство “wrap-mode”
“wrap-mode” PangoWrapMode
Определяет, как строка разбивается на несколько строк, если ячейка-рендерер не имеет достаточно места для отображения всей строки. Это свойство не действует, если свойство wrap-width не установлено.
Владелец: GtkCellRendererText
Флаги: Чтение / Запись
Значение по умолчанию: PANGO_WRAP_CHAR
С момента: 2.8
Свойство “wrap-width”
“wrap-width” int
Задает минимальную ширину, при которой текст переносится на новую строку. Свойство wrap-mode может влиять на то, в каких позициях символов могут быть сделаны разрывы строк. Установка wrap-width в -1 отключает перенос строк.
Владелец: GtkCellRendererText
Флаги: Чтение / Запись
Допустимые значения: >= -1
Значение по умолчанию: -1
С момента: 2.8
Подробное описание сигналов
Сигнал “edited”
void user_function (GtkCellRendererText *renderer, char *path, char *new_text, gpointer user_data)
Этот сигнал генерируется после редактирования renderer.
Приложение должно обновить модель и сохранить new_text в позиции, указанной path.
Параметры
renderer | объект, получивший сигнал | |
path | путь, идентифицирующий отредактированную ячейку | |
new_text | новый текст | |
user_data | пользовательские данные, установленные при подключении обработчика сигнала. |
Флаги: Выполнить последним
© 2005–2020 The GNOME Project
Licensed under the GNU Lesser General Public License version 2.1 or later.
https://developer.gnome.org/gtk3/3.24/GtkCellRendererText.html
