[ новости /+++ | форум | теги | ]

Каталог документации / Раздел "Программирование, языки" / Оглавление документа

Краткое описание

#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, то фиксированная высота не установлена, а высота определяется снова свойствами.

Детали свойств

Свойство "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

Партнёры:

Хостинг: