GTK+ Reference Manual |
||||
---|---|---|---|---|
Top | Description | Object Hierarchy | Properties | Signals |
GtkCellRendererTextGtkCellRendererText Представляет текст в ячейке |
#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 позволяет редактировать
текст используя ввод.
typedef struct _GtkCellRendererText GtkCellRendererText;
gtk_cell_renderer_text_new ()
GtkCellRenderer* gtk_cell_renderer_text_new (void);Создаёт новый GtkCellRendererText. Регулирует изображение текста используя свойства объекта. Свойства объекта могут быть установлены глобально (с помощью
g_object_set()
). Кроме того, с помощью GtkTreeViewColumn, вы можете привязать свойство к значению в GtkTreeModel. Например, вы можете свойство "text" ячейки представления привязать к значению строки в модели, таким образом представляя разные строки в каждой строке GtkTreeView
Возвращает : |
Новая ячейка представления |
void gtk_cell_renderer_text_set_fixed_height_from_font
(GtkCellRendererText *renderer,
gint number_of_rows);
Устанавливает высоту представления
явно определяя свойства "font" и
"y_pad". Дальнейшие изменения этих
свойств не влияют на высоту, поэтому
они должны сопровождаться повторным
вызовом этой функции. Использование
этой функции неудобно и должно в
действительности применяется только
для очень медленного расчета размера
ячейки (то есть, массивное число
отображаемых ячеек). Если number_of_rows
равен -1, то фиксированная высота не
установлена, а высота определяется
снова свойствами.
|
|
|
Количество строк текста каждой ячейки представления, или -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
|
Объект получающий сигнал. |
|
|
|
|
|
Пользовательские данные помещаемые при подключении обработчика сигнала. |