GtkCellRendererText
GtkCellRendererText — Отображает текст в ячейке
Функции
Свойства
| PangoStretch | наклон | Чтение / Запись |
| gboolean | установлен-наклон | Чтение / Запись |
| gboolean | зачеркнуто | Чтение / Запись |
| gboolean | установлено-зачеркнуто | Чтение / Запись |
| PangoStyle | стиль | Чтение / Запись |
| gboolean | установлен-стиль | Чтение / Запись |
| gchar * | текст | Чтение / Запись |
| PangoUnderline | подчёркивание | Чтение / Запись |
| gboolean | установлено-подчёркивание | Чтение / Запись |
| PangoVariant | вариант | Чтение / Запись |
| gboolean | установлен-вариант | Чтение / Запись |
| gint | вес | Чтение / Запись |
| gboolean | установлен-вес | Чтение / Запись |
| gint | ширина-символов | Чтение / Запись |
| PangoWrapMode | режим-переноса | Чтение / Запись |
| gint | ширина-переноса | Чтение / Запись |
Сигналы
Типы и значения
| структура | 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. Например, можно связать свойство «текст» в компоненте рендера с строковым значением в модели, тем самым отображая разные строки в каждой строке 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);
Устанавливает высоту рендера, чтобы она явно определялась свойствами «шрифт» и «y_pad», установленных на нём. Дальнейшие изменения этих свойств не влияют на высоту, поэтому они должны сопровождаться последующим вызовом этой функции. Использование этой функции негибкое и должно использоваться только в том случае, если вычисление размера ячейки слишком медленное (т.е., большое количество отображаемых ячеек). Если number_of_rows равно -1, то фиксированная высота сброшена, и высота определяется свойствами снова.
Параметры
renderer | ||
number_of_rows | Количество строк текста, выделенных для каждого рендера ячейки, или -1 |
Типы и значения
структура 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.20/GtkCellRendererText.html
