gtklabel

			gtk+ reference manual
top \| description \| object hierarchy \| implemented interfaces \| properties \| signals

gtklabel — виджет отображающий небольшое количество текста

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

#include <gtk/gtk.h>


            gtklabel;
gtkwidget*  gtk_label_new                   (const gchar *str);
void        gtk_label_set_text              (gtklabel *label,
                                             const gchar *str);
void        gtk_label_set_attributes        (gtklabel *label,
                                             pangoattrlist *attrs);
void        gtk_label_set_markup            (gtklabel *label,
                                             const gchar *str);
void        gtk_label_set_markup_with_mnemonic
                                            (gtklabel *label,
                                             const gchar *str);
void        gtk_label_set_pattern           (gtklabel *label,
                                             const gchar *pattern);
void        gtk_label_set_justify           (gtklabel *label,
                                             gtkjustification jtype);
void        gtk_label_set_ellipsize         (gtklabel *label,
                                             pangoellipsizemode mode);
void        gtk_label_set_width_chars       (gtklabel *label,
                                             gint n_chars);
void        gtk_label_set_max_width_chars   (gtklabel *label,
                                             gint n_chars);
void        gtk_label_get                   (gtklabel *label,
                                             gchar **str);
guint       gtk_label_parse_uline           (gtklabel *label,
                                             const gchar *string);
void        gtk_label_set_line_wrap         (gtklabel *label,
                                             gboolean wrap);
void        gtk_label_set_line_wrap_mode    (gtklabel *label,
                                             pangowrapmode wrap_mode);
#define     gtk_label_set
void        gtk_label_get_layout_offsets    (gtklabel *label,
                                             gint *x,
                                             gint *y);
guint       gtk_label_get_mnemonic_keyval   (gtklabel *label);
gboolean    gtk_label_get_selectable        (gtklabel *label);
const gchar* gtk_label_get_text             (gtklabel *label);
gtkwidget*  gtk_label_new_with_mnemonic     (const gchar *str);
void        gtk_label_select_region         (gtklabel *label,
                                             gint start_offset,
                                             gint end_offset);
void        gtk_label_set_mnemonic_widget   (gtklabel *label,
                                             gtkwidget *widget);
void        gtk_label_set_selectable        (gtklabel *label,
                                             gboolean setting);
void        gtk_label_set_text_with_mnemonic
                                            (gtklabel *label,
                                             const gchar *str);
pangoattrlist* gtk_label_get_attributes     (gtklabel *label);
gtkjustification gtk_label_get_justify      (gtklabel *label);
pangoellipsizemode gtk_label_get_ellipsize  (gtklabel *label);
gint        gtk_label_get_width_chars       (gtklabel *label);
gint        gtk_label_get_max_width_chars   (gtklabel *label);
const gchar* gtk_label_get_label            (gtklabel *label);
pangolayout* gtk_label_get_layout           (gtklabel *label);
gboolean    gtk_label_get_line_wrap         (gtklabel *label);
pangowrapmode gtk_label_get_line_wrap_mode  (gtklabel *label);
gtkwidget*  gtk_label_get_mnemonic_widget   (gtklabel *label);
gboolean    gtk_label_get_selection_bounds  (gtklabel *label,
                                             gint *start,
                                             gint *end);
gboolean    gtk_label_get_use_markup        (gtklabel *label);
gboolean    gtk_label_get_use_underline     (gtklabel *label);
gboolean    gtk_label_get_single_line_mode  (gtklabel *label);
gdouble     gtk_label_get_angle             (gtklabel *label);
void        gtk_label_set_label             (gtklabel *label,
                                             const gchar *str);
void        gtk_label_set_use_markup        (gtklabel *label,
                                             gboolean setting);
void        gtk_label_set_use_underline     (gtklabel *label,
                                             gboolean setting);
void        gtk_label_set_single_line_mode  (gtklabel *label,
                                             gboolean single_line_mode);
void        gtk_label_set_angle             (gtklabel *label,
                                             gdouble angle);

иерархия объектов

  gobject
   +----ginitiallyunowned
         +----gtkobject
               +----gtkwidget
                     +----gtkmisc
                           +----gtklabel
                                 +----gtkaccellabel
                                 +----gtktipsquery

осуществляемые интерфейсы

gtklabel осуществляет atkimplementoriface.

свойства

  "angle"                gdouble               : read / write
  "attributes"           pangoattrlist         : read / write
  "cursor-position"      gint                  : read
  "ellipsize"            pangoellipsizemode    : read / write
  "justify"              gtkjustification      : read / write
  "label"                gchararray            : read / write
  "max-width-chars"      gint                  : read / write
  "mnemonic-keyval"      guint                 : read
  "mnemonic-widget"      gtkwidget             : read / write
  "pattern"              gchararray            : write
  "selectable"           gboolean              : read / write
  "selection-bound"      gint                  : read
  "single-line-mode"     gboolean              : read / write
  "use-markup"           gboolean              : read / write
  "use-underline"        gboolean              : read / write
  "width-chars"          gint                  : read / write
  "wrap"                 gboolean              : read / write
  "wrap-mode"            pangowrapmode         : read / write

сигналы

"copy-clipboard"
            void        user_function      (gtklabel *label,
                                            gpointer  user_data)      : run last / action
"move-cursor"
            void        user_function      (gtklabel        *label,
                                            gtkmovementstep *arg1,
                                            gint             arg2,
                                            gboolean         arg3,
                                            gpointer         user_data)      : run last / action
"populate-popup"
            void        user_function      (gtklabel *label,
                                            gtkmenu  *arg1,
                                            gpointer  user_data)      : run last

описание

gtklabel отображает небольшое количество текста. как подразумевает название, большинство ярлыков используется для маркировки других виджетов таких как gtkbutton, gtkmenuitem, или gtkoptionmenu.

мнемоники

ярлыки могут содержать mnemonics. мнемоники являются подчеркнутыми символами в ярлыках, используемые для обозначения клавиш. мнемоники создаются, обеспечивая строку с подчеркиванием перед символом мнемоника, таких как "_file", функциями gtk_label_new_with_mnemonic() или gtk_label_set_text_with_mnemonic().

мнемоники автоматически активизируются любым активизируемым виджетом с ярлыком, таким как gtkbutton; если ярлык внутри виджета не имеет мнемонической цели, вы можете сообщить ярлыку об этой цели используя gtk_label_set_mnemonic_widget(). вот небольшой пример ярлыка внутри кнопки:

  /* нажатие клавиш alt+h активизирует эту кнопку */
  button = gtk_button_new ();
  label = gtk_label_new_with_mnemonic ("_hello");
  gtk_container_add (gtk_container (button), label);

вот удобная функция создания кнопки сразу с мнемоническим ярлыком внутри:

  /* нажатие клавиш alt+h активизирует эту кнопку */
  button = gtk_button_new_with_mnemonic ("_hello");

для создания мнемоника рядом с ярлыком виджета, такого как gtkentry, вы можете установить ярлык ввода с помощью gtk_label_set_mnemonic_widget():

  /* нажатие alt+h сфокусирует поле ввода */
  entry = gtk_entry_new ();
  label = gtk_label_new_with_mnemonic ("_hello");
  gtk_label_set_mnemonic_widget (gtk_label (label), entry);

разметка (стилизованный текст)

для создания форматированного текста внутри ярлыка (изменяемый цвет, шрифт, и т.д..), текст ярлыка можно обеспечить в простом markup format. вот так можно создать ярлык с маленьким шрифтом:

  label = gtk_label_new (null);
  gtk_label_set_markup (gtk_label (label), "<small>small text</small>");

(смотрите полную документацию доступных тэгов в pango руководстве.)

разметка помещаемая в gtk_label_set_markup() должна быть допустимой; например, </>/& символы должны быть управляющей последовательностью как <, >, и &. если вы помещаете текст полученный от пользователя, из файла, или сети в gtk_label_set_markup(), вам необходимо создать управляющую последовательность для него с помощью g_markup_escape_text() или g_markup_printf_escaped().

разметка строки простой способ установить pangoattrlist на ярлык; gtk_label_set_attributes() может быть более простым способом установки атрибутов в некоторых случаях. хотя будьте осторожны; pangoattrlist имеет тенденцию вызывать проблемы интернационализации, если вы не применяете атрибуты ко всей строке (то есть если вы установили диапазон каждого атрибута в [0, g_maxint)). аргументы которые определяют start_index и end_index для pangoattribute требуют отображения точной строки, поэтому при переводе могут возникнуть проблемы.

выделяемые ярлыки

ярлыки могут быть сделаны выделяемыми с помощью gtk_label_set_selectable(). выделяемые ярлыки позволяют пользователю копировать своё содержимое в буфер. только ярлыки содержащие информацию полезную для копирования — такие как сообщения об ошибках (error messages) — должны быть выделяемыми.

выравнивание текста

ярлыки могут содержать любое количество параграфов, но будут иметь проблемы выполнения если их слишком много. параграфы разделяются новой строкой или другим разделителем параграфов понятным для pango.

ярлык может автоматически упаковать текст если вы вызовите gtk_label_set_line_wrap().

gtk_label_set_justify() устанавливает как линии текста выравниваются относительно друг друга. если вы хотите установить как ярлык в целом выравнивается в доступном пространстве, смотрите gtk_misc_set_alignment().

детали

gtklabel

typedef struct _gtklabel gtklabel;

к этой структуре нет непосредственного доступа. для доступа к ней используйте функции приведенные ниже.

gtk_label_new ()

gtkwidget*  gtk_label_new                   (const gchar *str);

создаёт новый ярлык с данным текстом внутри. вы можете поместить null для получения пустого ярлыка.

`str` :	текст ярлыка
возвращает :	новый gtklabel

gtk_label_set_text ()

void        gtk_label_set_text              (gtklabel *label,
                                             const gchar *str);

устанавливает текст внутри gtklabel виджета. перезаписывает текст установленный ранее.

это также очистит любые предварительно установленные мнемонические акселераторы.

`label` :	gtklabel
`str` :	текст который вы хотите установить.

gtk_label_set_attributes ()

void        gtk_label_set_attributes        (gtklabel *label,
                                             pangoattrlist *attrs);

устанавливает pangoattrlist; атрибуты в списке применяются к тексту ярлыка. атрибуты установленные с помощью этой функции будут игнорироваться если свойство "use_underline" или свойство "use_markup" равны true.

`label` :	gtklabel
`attrs` :	pangoattrlist

gtk_label_set_markup ()

void        gtk_label_set_markup            (gtklabel *label,
                                             const gchar *str);

анализирует str которая размечена с помощью pango text markup language, устанавливает текст ярлыков и список атрибутов основываясь на результате анализа. если str внешние данные, вам нужно для них использовать g_markup_escape_text() или g_markup_printf_escaped():

char *markup;

markup = g_markup_printf_escaped ("<span style=\"italic\">%s</span>", str);
gtk_label_set_markup (gtk_label (label), markup);
g_free (markup);

`label` :	gtklabel
`str` :	размеченная строка (смотрите pango markup format)

gtk_label_set_markup_with_mnemonic ()

void        gtk_label_set_markup_with_mnemonic
                                            (gtklabel *label,
                                             const gchar *str);

анализирует str которая размечена с помощью pango text markup language, устанавливает текст ярлыков и список атрибутов основываясь на результате анализа. если символам в str предшествует подчеркивание, оно указывает клавиатурный акселератор называемый мнемоником.

мнемоник может использоваться для активации другого виджета, выбранный автоматически, или явно использующий gtk_label_set_mnemonic_widget().

`label` :	gtklabel
`str` :	размеченная строка (смотрите pango markup format)

gtk_label_set_pattern ()

void        gtk_label_set_pattern           (gtklabel *label,
                                             const gchar *pattern);

шаблон подчеркивания существующего текста внутри gtklabel виджета. например если текущий текст ярлыка скажем "foobarbaz" помещённый шаблон "___ ___" подчеркнет "foo" и "baz" но не "bar".

`label` :	gtklabel для которого вы хотите установить шаблон.
`pattern` :	шаблон как описано выше.

gtk_label_set_justify ()

void        gtk_label_set_justify           (gtklabel *label,
                                             gtkjustification jtype);

устанавливает выравнивание линий внутри ярлыка относительно друг друга. gtk_justify_left значение по умолчанию когда виджет впервые создаётся с помощью gtk_label_new(). если вы хотите установить выравнивание ярлыка в целом, используйте gtk_misc_set_alignment(). gtk_label_set_justify() не имеет эффекта на ярлыки содержащие только одну линию.

`label` :	gtklabel
`jtype` :	gtkjustification

gtk_label_set_ellipsize ()

void        gtk_label_set_ellipsize         (gtklabel *label,
                                             pangoellipsizemode mode);

устанавливает режим используемый для заполнения (ellipsize) (добавляет заполнение: "...") текста если для строки не достаточно свободного пространства.

`label` :	gtklabel
`mode` :	pangoellipsizemode

начиная с версии 2.6

gtk_label_set_width_chars ()

void        gtk_label_set_width_chars       (gtklabel *label,
                                             gint n_chars);

устанавливает желательную ширину в символах для label равную n_chars.

`label` :	gtklabel
`n_chars` :	новая желательная ширина в символах.

начиная с версии 2.6

gtk_label_set_max_width_chars ()

void        gtk_label_set_max_width_chars   (gtklabel *label,
                                             gint n_chars);

устанавливает желательную максимальную ширину в символах для label равную n_chars.

`label` :	gtklabel
`n_chars` :	новая максимальная ширина в символах.

начиная с версии 2.6

gtk_label_get ()

void        gtk_label_get                   (gtklabel *label,
                                             gchar **str);

внимание

gtk_label_get устарела и не должна использоваться во вновь создаваемом коде.

выдает текущий текст внутри gtklabel и записывает его в полученную как аргумент str строку. она не создаёт копию этой строки поэтому вы не должны ее записывать.

`label` :	gtklabel из которого вы хотите получить текст.
`str` :	указатель на точку куда вы хотите поместить текст.

gtk_label_parse_uline ()

guint       gtk_label_parse_uline           (gtklabel *label,
                                             const gchar *string);

внимание

gtk_label_parse_uline устарела и не должна использоваться во вновь создаваемом коде.

анализирует полученную строку для подчеркивания и преобразует следующие символы в подчеркнутые. эта функция используется только внутри библиотеки gtk+ для пунктов меню и подобного.

`label` :	gtklabel который вы хотите проанализировать.
`string` :	строка которую вы хотите проанализировать.
возвращает :	строчную букву последнего подчеркнутого символа.

gtk_label_set_line_wrap ()

void        gtk_label_set_line_wrap         (gtklabel *label,
                                             gboolean wrap);

переключает оболочку линий в пределах gtklabel виджета. true заставляет нарушать линии если текст превышает размер виджета. false позволяет виджету обрезать текст когда он превышает его размер.

помните установка оболочки линий равной true не создаёт оболочку линий шириной родительского контейнера, потому что gtk+ виджеты концептуально не создают запрос зависящий от размера родительского контейнера. для ярлыка который создаёт оболочку в определённом положении, установите ширину используя gtk_widget_set_size_request().

`label` :	gtklabel
`wrap` :	установки

gtk_label_set_line_wrap_mode ()

void        gtk_label_set_line_wrap_mode    (gtklabel *label,
                                             pangowrapmode wrap_mode);

если оболочка линий включена (смотрите gtk_label_set_line_wrap()) эта функция помогает управлять режимами оболочки. по умолчанию pango_wrap_word означающая оболочку по границам слова.

`label` :	gtklabel
`wrap_mode` :	режим оболочки линий

начиная с версии 2.10

gtk_label_set

#define  gtk_label_set           gtk_label_set_text

внимание

gtk_label_set устарела и не должна использоваться во вновь создаваемом коде.

аналог gtk_label_set_text(). используется только для совместимости с gtk+ 1.0.x.

gtk_label_get_layout_offsets ()

void        gtk_label_get_layout_offsets    (gtklabel *label,
                                             gint *x,
                                             gint *y);

получает координаты расположения текста в ярлыке представленного с помощью pangolayout; полезно для преобразования событий мышки в координаты внутри pangolayout, например для получения некоторых действий если некоторая часть ярлыка нажата (clicked). естественно вам нужно создать gtkeventbox для получения событий и упаковать в него ярлык, поскольку ярлыки являются виджетами без окна gtk_no_window. помните, когда вы используете pangolayout функции вам нужно преобразовывать из и в pixels используя pango_pixels() или pango_scale.

`label` :	gtklabel
`x` :	x координаты выравнивания, или `null`
`y` :	y координаты выравнивания, или `null`

gtk_label_get_mnemonic_keyval ()

guint       gtk_label_get_mnemonic_keyval   (gtklabel *label);

если ярлык имеет установленный мнемоник эта функция возвращает значение клавиш мнемонического акселератора. если нет установленного мнемоника то возвращается gdk_voidsymbol.

`label` :	gtklabel
возвращает :	gdk значение клавиш для акселератора, или gdk_voidsymbol

gtk_label_get_selectable ()

gboolean    gtk_label_get_selectable        (gtklabel *label);

выдаёт значение установленное с помощью gtk_label_set_selectable().

`label` :	gtklabel
возвращает :	`true` если пользователь может копировать текст из ярлыка

gtk_label_get_text ()

const gchar* gtk_label_get_text             (gtklabel *label);

выдаёт текст из ярлыка, как отображаемый на экране. он не будет содержать подчеркиваний указывающих на мнемоник или pango разметку. (смотрите gtk_label_get_label())

`label` :	gtklabel
возвращает :	текст в ярлыке. это внутренняя строка используемая ярлыком и она не должна модифицироваться.

gtk_label_new_with_mnemonic ()

gtkwidget*  gtk_label_new_with_mnemonic     (const gchar *str);

создаёт новый gtklabel, содержащий текст в str.

если символам в str предшествует подчеркивание, она будет подчеркнутой. если вам нужен символ подчеркивания в ярлыке, используйте '__' (двойное подчеркивание). первый символ подчёркивания представляет клавиатурный акселератор называемый мнемоник. мнемоник может использоваться для активации другого виджета, выбранный автоматически, или явно использующий gtk_label_set_mnemonic_widget().

если gtk_label_set_mnemonic_widget() не вызвана, то когда первый доступный для активации предок gtklabel будет выбран как мнемонический виджет. например, если ярлык находится внутри кнопки или пункта меню, кнопка или пункт меню будут автоматически становиться мнемоническими виджетами и будут активироваться мнемоником.

`str` :	текст ярлыка, с подчёркиванием перед мнемоническим символом
возвращает :	новый gtklabel

gtk_label_select_region ()

void        gtk_label_select_region         (gtklabel *label,
                                             gint start_offset,
                                             gint end_offset);

выделяет диапазон символов в ярлыке, если ярлык доступен для выделения. смотрите gtk_label_set_selectable(). если ярлык не доступен для выделения, эта функция не имеет эфекта. если start_offset или end_offset равно -1, то конец ярлыка будет заменен.

`label` :	gtklabel
`start_offset` :	начало замещения (в символах не в байтах)
`end_offset` :	конец замещения (в символах не в байтах)

gtk_label_set_mnemonic_widget ()

void        gtk_label_set_mnemonic_widget   (gtklabel *label,
                                             gtkwidget *widget);

если ярлык имеет установленный мнемоник (используя например gtk_label_set_markup_with_mnemonic(), gtk_label_set_text_with_mnemonic(), gtk_label_new_with_mnemonic() или свойство "use_underline") он может быть связан с виджетом который является целью мнемоника. когда ярлык внутри виджета (например gtkbutton или gtknotebook вкладок) он автоматически связан с текущим виджетом, но иногда (например когда цель gtkentry рядом с ярлыком) вам нужно установить явное использование этой функции.

целевой виджет будет иметь акселератор издающий сигнал "mnemonic_activate". по умолчанию обработчик этого сигнала будет активировать виджет если нет никаких мнемонических коллизий, иначе переключит фокус между конфликтующими виджетами.

`label` :	gtklabel
`widget` :	целевой gtkwidget

gtk_label_set_selectable ()

void        gtk_label_set_selectable        (gtklabel *label,
                                             gboolean setting);

позволяет пользователю копировать текст из ярлыка, для процесса copy-and-paste.

`label` :	gtklabel
`setting` :	`true` для разрешения выделения текста ярлыка

gtk_label_set_text_with_mnemonic ()

void        gtk_label_set_text_with_mnemonic
                                            (gtklabel *label,
                                             const gchar *str);

устанавливает текст ярлыка из строки str. если символам в str предшествует подчеркивание, они подчеркиваются сообщая что они представляют акселератор клавиатуры называемый мнемоник. мнемоник может использоваться для активации другого виджета, выбранный автоматически, или явно использующий gtk_label_set_mnemonic_widget().

`label` :	gtklabel
`str` :	строка

gtk_label_get_attributes ()

pangoattrlist* gtk_label_get_attributes     (gtklabel *label);

выдаёт список атрибутов которые установлены на ярлыке с использованием gtk_label_set_attributes(), если есть. эта функция не отбирает атрибуты из размеченных ярлыков (смотрите gtk_label_set_markup()). если вам нужно получить эффективные атрибуты для ярлыка, используйте pango_layout_get_attribute (gtk_label_get_layout (label)).

`label` :	gtklabel
возвращает :	список атрибутов, или `null` если не установлены.

gtk_label_get_justify ()

gtkjustification gtk_label_get_justify      (gtklabel *label);

возвращает выравнивание ярлыка. смотрите gtk_label_set_justify().

`label` :	gtklabel
возвращает :	gtkjustification

gtk_label_get_ellipsize ()

pangoellipsizemode gtk_label_get_ellipsize  (gtklabel *label);

возвращает возможность заполнения ярлыка. смотрите gtk_label_set_ellipsize().

`label` :	gtklabel
возвращает :	pangoellipsizemode

начиная с версии 2.6

gtk_label_get_width_chars ()

gint        gtk_label_get_width_chars       (gtklabel *label);

находит желательную ширину label, в символах. смотрите gtk_label_set_width_chars().

`label` :	gtklabel
возвращает :	ширина ярлыка в символах.

начиная с версии 2.6

gtk_label_get_max_width_chars ()

gint        gtk_label_get_max_width_chars   (gtklabel *label);

находит желательный максимум ширины label, в символах. смотрите gtk_label_set_width_chars().

`label` :	gtklabel
возвращает :	максимальная ширина ярлыка в символах.

начиная с версии 2.6

gtk_label_get_label ()

const gchar* gtk_label_get_label            (gtklabel *label);

возвращает текст ярлыка включая любой вложенный индикатор мнемоника и pango разметку. (смотрите gtk_label_get_text()).

`label` :	gtklabel
возвращает :	текст ярлыка. этой строкой владеет виджет и она не должна модифицироваться или освобождаться.

gtk_label_get_layout ()

pangolayout* gtk_label_get_layout           (gtklabel *label);

выдаёт pangolayout используемый для отображения ярлыка. выравнивание полезно например для конвертации текстовой позиции в pixel позицию, в комбинации с gtk_label_get_layout_offsets(). возвращаемым выравниванием владеет ярлык и его не нужно освобождать.

`label` :	gtklabel
возвращает :	pangolayout для этого ярлыка

gtk_label_get_line_wrap ()

gboolean    gtk_label_get_line_wrap         (gtklabel *label);

возвращает включена ли автоматическая оболочка для линий ярлыка. смотрите gtk_label_set_line_wrap().

`label` :	gtklabel
возвращает :	`true` если линии ярлыка автоматически в оболочке.

gtk_label_get_line_wrap_mode ()

pangowrapmode gtk_label_get_line_wrap_mode  (gtklabel *label);

возвращает используемый режим для оболочки линий ярлыка. смотрите gtk_label_set_line_wrap_mode().

`label` :	gtklabel
возвращает :	`true` если линии ярлыка автоматически в оболочке.

начиная с версии 2.10

gtk_label_get_mnemonic_widget ()

gtkwidget*  gtk_label_get_mnemonic_widget   (gtklabel *label);

определяет цель мнемоника (клавиатурное сокращение) для этого ярлыка. смотрите gtk_label_set_mnemonic_widget().

`label` :	gtklabel
возвращает :	цель мнемоника ярлыка, или `null` если нет установленных и используется алгоритм по умолчанию.

gtk_label_get_selection_bounds ()

gboolean    gtk_label_get_selection_bounds  (gtklabel *label,
                                             gint *start,
                                             gint *end);

определяет выделяемую область символов в ярлыке, возвращает true если она выделена.

`label` :	gtklabel
`start` :	место для хранения возвращаемого значения начала выделения, как смещение в символах.
`end` :	место для хранения возвращаемого значения конца выделения, как смещение в символах.
возвращает :	`true` если выделение не пустое

gtk_label_get_use_markup ()

gboolean    gtk_label_get_use_markup        (gtklabel *label);

возвращает нужно ли интерпретировать текст как размеченный с помощью pango text markup language. смотрите gtk_label_set_use_markup().

`label` :	gtklabel
возвращает :	`true` если текст должен анализироваться как размеченный.

gtk_label_get_use_underline ()

gboolean    gtk_label_get_use_underline     (gtklabel *label);

возвращает указывает ли подчеркивание в ярлыке на мнемоник. смотрите gtk_label_set_use_underline().

`label` :	gtklabel
возвращает :	`true` если встроенное подчеркивание указывает на мнемонический акселератор.

gtk_label_get_single_line_mode ()

gboolean    gtk_label_get_single_line_mode  (gtklabel *label);

возвращает находится ли ярлык в режиме одиночной линии.

`label` :	gtklabel
возвращает :	`true` когда ярлык в режиме одиночной линии.

начиная с версии 2.6

gtk_label_get_angle ()

gdouble     gtk_label_get_angle             (gtklabel *label);

выдаёт угол поворота ярлыка. смотрите gtk_label_set_angle.

`label` :	gtklabel
возвращает :	угол поворота для ярлыка

начиная с версии 2.6

gtk_label_set_label ()

void        gtk_label_set_label             (gtklabel *label,
                                             const gchar *str);

устанавливает текст ярлыка. ярлык интерпретируется как включающий подчеркивание и/или pango разметку зависимости от значений label->use_underline и label->use_markup.

`label` :	gtklabel
`str` :	новый текст установленный для ярлыка

gtk_label_set_use_markup ()

void        gtk_label_set_use_markup        (gtklabel *label,
                                             gboolean setting);

устанавливает должен ли текст ярлыка содержать разметку в pango's text markup language. смотрите gtk_label_set_markup().

`label` :	gtklabel
`setting` :	`true` если текст должен быть проанализирован как разметка.

gtk_label_set_use_underline ()

void        gtk_label_set_use_underline     (gtklabel *label,
                                             gboolean setting);

если положительно, подчеркивание в тексте сообщает что следующий символ должен быть использован для мнемонического клавиатурного акселератора.

`label` :	gtklabel
`setting` :	`true` если подчеркивание указывает на мнемоник

gtk_label_set_single_line_mode ()

void        gtk_label_set_single_line_mode  (gtklabel *label,
                                             gboolean single_line_mode);

устанавливает должен ли ярлык находится в режиме одиночной линии.

`label` :	gtklabel
`single_line_mode` :	`true` если ярлык должен быть в режиме одиночной линии

начиная с версии 2.6

gtk_label_set_angle ()

void        gtk_label_set_angle             (gtklabel *label,
                                             gdouble angle);

устанавливает угол поворота для ярлыка. угол 90 читается как снизу в верх, угол 270, сверху в низ. установки угла для ярлыка игнорируются если ярлык выделяемый, в оболочке, или заполняемый.

`label` :	gtklabel
`angle` :	угол основной линии в градусах по часовой стрелке

начиная с версии 2.6

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

свойство "`angle`"

  "angle"                gdouble               : read / write

угол основной линии ярлыка в градусах по часовой стрелке. угол 90 читается снизу в верх, угол 270, с верху в низ. игнорируется если ярлык выделяем, в оболочке, или заполняемый (ellipsized).

допустимые значения: [0,360]

значение по умолчанию: 0

начиная с версии 2.6

свойство "`attributes`"

  "attributes"           pangoattrlist         : read / write

список атрибутов стиля применяемых к тексту ярлыка.

свойство "`cursor-position`"

  "cursor-position"      gint                  : read

текущая позиция вставки курсора в символах.

допустимые значения: >= 0

значение по умолчанию: 0

свойство "`ellipsize`"

  "ellipsize"            pangoellipsizemode    : read / write

дополнение для заполняемой строки, если ярлык не имеет достаточного пространства для всей строки, обуславливается pangoellisizemode.

помните что установка этого свойства в значение отличающееся от pango_ellipsize_none имеет побочный эффект, ярлык запрашивает достаточное пространство только для отображения "...". в частности это означает что заполняемые ярлыки не работают на вкладках, если свойство вкладки ::tab-expand установлено в true. другой способ установить ширину ярлыка gtk_widget_set_size_request() и gtk_label_set_width_chars().

значение по умолчанию: pango_ellipsize_none

начиная с версии 2.6

свойство "`justify`"

  "justify"              gtkjustification      : read / write

выравнивание линий текста ярлыка относительно друг друга. это не касается выравнивания ярлыка в пределах его размещения. смотрите gtkmisc::xalign для этого.

значение по умолчанию: gtk_justify_left

свойство "`label`"

  "label"                gchararray            : read / write

текст ярлыка.

значение по умолчанию: null

свойство "`max-width-chars`"

  "max-width-chars"      gint                  : read / write

желаемый максимум ширины ярлыка, в символах. если это свойство установлено в -1, ширина расчитывается автоматически, иначе ярлык запрашивает пространство не большее чем требуемое число символов. если свойство width-chars установлено в положительное значение, то когда свойство max-width-chars игнорируется.

допустимые значения: >= -1

значение по умолчанию: -1

начиная с версии 2.6

свойство "`mnemonic-keyval`"

  "mnemonic-keyval"      guint                 : read

мнемонический акселератор для данного ярлыка.

значение по умолчанию: 16777215

свойство "`mnemonic-widget`"

  "mnemonic-widget"      gtkwidget             : read / write

виджет активируемый при нажатии клавиш мнемоника соответствующих ярлыку.

свойство "`pattern`"

  "pattern"              gchararray            : write

строка символов подчеркивания _ в позициях сообщающих о подчеркнутом тексте.

значение по умолчанию: null

свойство "`selectable`"

  "selectable"           gboolean              : read / write

может ли ярлык выделяться мышью.

значение по умолчанию: false

свойство "`selection-bound`"

  "selection-bound"      gint                  : read

позиция противоположного конца выделения от курсора в символах.

допустимые значения: >= 0

значение по умолчанию: 0

свойство "`single-line-mode`"

  "single-line-mode"     gboolean              : read / write

находится ли ярлык в режиме единственной линии. в режиме единственной линии, высота ярлыка не зависит от фактического текста, она всегда установлена в подъём+падение (ascent + descent) шрифта. это может быть преимуществом в ситуациях когда изменение высоты ярлыка недопустимо, например панель состояния (statusbar).

значение по умолчанию: false

начиная с версии 2.6

свойство "`use-markup`"

  "use-markup"           gboolean              : read / write

текст ярлыка включающий xml разметку. смотрите pango_parse_markup().

значение по умолчанию: false

свойство "`use-underline`"

  "use-underline"        gboolean              : read / write

если установлено, подчеркивание в ярлыке указывает на то что следующий за ним символ должен использоваться как мнемоник.

значение по умолчанию: false

свойство "`width-chars`"

  "width-chars"          gint                  : read / write

желаемая ширина ярлыка, в символах. если это свойство установлено равным -1, ширина будет рассчитана автоматически, иначе ярлык запросит или 3 символа или значение свойства, смотря что больше. если свойство width-chars установлено в положительное значение, свойство max-width-chars игнорируется.

допустимые значения: >= -1

значение по умолчанию: -1

начиная с версии 2.6

свойство "`wrap`"

  "wrap"                 gboolean              : read / write

если установлено, линии помещаются в оболочку если текст становится слишком широким.

значение по умолчанию: false

свойство "`wrap-mode`"

  "wrap-mode"            pangowrapmode         : read / write

если оболочка линий включена (смотрите свойство оболочки) это свойство контролирует как оболочка выполняется. по умолчанию pango_wrap_word что означает размещение в оболочке по границе слова.

значение по умолчанию: pango_wrap_word

начиная с версии 2.10

детали сигналов

сигнал "copy-clipboard"

void        user_function                  (gtklabel *label,
                                            gpointer  user_data)      : run last / action

`label` :	объект получающий сигнал.
`user_data` :	пользовательские данные устанавливаемые при подключении обработчика.

сигнал "move-cursor"

void        user_function                  (gtklabel        *label,
                                            gtkmovementstep *arg1,
                                            gint             arg2,
                                            gboolean         arg3,
                                            gpointer         user_data)      : run last / action

`label` :	объект получающий сигнал.
`arg1` :
`arg2` :
`arg3` :
`user_data` :	пользовательские данные устанавливаемые при подключении обработчика.

сигнал "populate-popup"

void        user_function                  (gtklabel *label,
                                            gtkmenu  *arg1,
                                            gpointer  user_data)      : run last

`label` :	объект получающий сигнал.
`arg1` :
`user_data` :	пользовательские данные устанавливаемые при подключении обработчика.

gtklabel

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

иерархия объектов

осуществляемые интерфейсы

свойства

сигналы

описание

мнемоники

разметка (стилизованный текст)

выделяемые ярлыки

выравнивание текста

детали

gtklabel

gtk_label_new ()

gtk_label_set_text ()

gtk_label_set_attributes ()

gtk_label_set_markup ()

gtk_label_set_markup_with_mnemonic ()

gtk_label_set_pattern ()

gtk_label_set_justify ()

gtk_label_set_ellipsize ()

gtk_label_set_width_chars ()

gtk_label_set_max_width_chars ()

gtk_label_get ()

внимание

gtk_label_parse_uline ()

внимание

gtk_label_set_line_wrap ()

gtk_label_set_line_wrap_mode ()

gtk_label_set

внимание

gtk_label_get_layout_offsets ()

gtk_label_get_mnemonic_keyval ()

gtk_label_get_selectable ()

gtk_label_get_text ()

gtk_label_new_with_mnemonic ()

gtk_label_select_region ()

gtk_label_set_mnemonic_widget ()

gtk_label_set_selectable ()

gtk_label_set_text_with_mnemonic ()

gtk_label_get_attributes ()

gtk_label_get_justify ()

gtk_label_get_ellipsize ()

gtk_label_get_width_chars ()

gtk_label_get_max_width_chars ()

gtk_label_get_label ()

gtk_label_get_layout ()

gtk_label_get_line_wrap ()

gtk_label_get_line_wrap_mode ()

gtk_label_get_mnemonic_widget ()

gtk_label_get_selection_bounds ()

gtk_label_get_use_markup ()

gtk_label_get_use_underline ()

gtk_label_get_single_line_mode ()

gtk_label_get_angle ()

gtk_label_set_label ()

gtk_label_set_use_markup ()

gtk_label_set_use_underline ()

gtk_label_set_single_line_mode ()

gtk_label_set_angle ()

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

свойство "angle"

свойство "attributes"

свойство "cursor-position"

свойство "ellipsize"

свойство "justify"

свойство "label"

свойство "max-width-chars"

свойство "mnemonic-keyval"

свойство "mnemonic-widget"

свойство "pattern"

свойство "selectable"

свойство "selection-bound"

свойство "single-line-mode"

свойство "use-markup"

свойство "use-underline"

свойство "width-chars"

свойство "wrap"

свойство "wrap-mode"

детали сигналов

свойство "`angle`"

свойство "`attributes`"

свойство "`cursor-position`"

свойство "`ellipsize`"

свойство "`justify`"

свойство "`label`"

свойство "`max-width-chars`"

свойство "`mnemonic-keyval`"

свойство "`mnemonic-widget`"

свойство "`pattern`"

свойство "`selectable`"

свойство "`selection-bound`"

свойство "`single-line-mode`"

свойство "`use-markup`"

свойство "`use-underline`"

свойство "`width-chars`"

свойство "`wrap`"

свойство "`wrap-mode`"