gtkcellrenderertext
gtkcellrenderertext — представляет текст в
ячейке
|
|
краткое описание
#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 позволяет редактировать
текст используя ввод.
детали
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
возвращает :
|
новая ячейка представления
|
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
|
детали свойств
свойство "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
cellrenderertext :
|
объект получающий сигнал.
|
arg1 :
|
|
arg2 :
|
|
user_data :
|
пользовательские данные помещаемые
при подключении обработчика сигнала.
|
|