GtkLabel

gtk_label_new ()

GtkWidget *
gtk_label_new (const gchar *str);

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

gtk_label_set_text ()

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

Устанавливает текст внутри виджета GtkLabel. Заменяет любой ранее установленный текст.

Эта функция очистит любые ранее установленные мнемонические сочетания клавиш и установит свойство “use-underline” в FALSE в качестве побочного эффекта.

Эта функция установит свойство “use-markup” в FALSE в качестве побочного эффекта.

См. также: gtk_label_set_markup()

gtk_label_set_attributes ()

void
gtk_label_set_attributes (GtkLabel *label,
                          PangoAttrList *attrs);

Устанавливает PangoAttrList; атрибуты в списке применяются к тексту ярлыка.

Атрибуты, установленные с помощью этой функции, будут применены и объединены с любыми другими атрибутами, ранее установленные с помощью свойств “use-underline” или “use-markup”. Хотя не рекомендуется смешивать строки разметки с вручную заданными атрибутами, если вы это сделаете, знайте, что атрибуты будут применены к ярлыку после разбора строки разметки.

gtk_label_set_markup ()

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

Разбирает str, который помечен разметкой языка Pango, устанавливая текст ярлыка и список атрибутов на основе результатов разбора.

Если str содержит внешние данные, вам может потребоваться экранировать их с помощью g_markup_escape_text() или g_markup_printf_escaped():

label
├── [selection]
├── [link]
┊
╰── [link]

Эта функция установит свойство “use-markup” в TRUE в качестве побочного эффекта.

Если вы устанавливаете содержимое ярлыка с помощью свойства “label”, вы также должны убедиться, что вы установили свойство “use-markup” соответственно.

См. также: gtk_label_set_text()

gtk_label_set_markup_with_mnemonic ()

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

Разбирает str, который помечен разметкой языка Pango, устанавливая текст ярлыка и список атрибутов на основе результатов разбора. Если символы в str предваряются подчёркиванием, они подчёркиваются, указывая, что они представляют собой сочетание клавиш, называемое мнемоником.

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

gtk_label_set_pattern ()

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

Образец подчёркиваний, который вы хотите под существующим текстом внутри виджета GtkLabel. Например, если текущий текст ярлыка «FooBarBaz», передача шаблона «___ ___» подчёркнет «Foo» и «Baz», но не «Bar».

gtk_label_set_justify ()

void
gtk_label_set_justify (GtkLabel *label,
                       GtkJustification jtype);

Устанавливает выравнивание строк в тексте ярлыка относительно друг друга. GTK_JUSTIFY_LEFT является значением по умолчанию при первом создании виджета с помощью gtk_label_new(). Если вы хотите установить выравнивание всего ярлыка, используйте gtk_widget_set_halign() вместо этого. gtk_label_set_justify() не влияет на ярлыки, содержащие только одну строку.

gtk_label_set_xalign ()

void
gtk_label_set_xalign (GtkLabel *label,
                      gfloat xalign);

Устанавливает свойство “xalign” для label .

С: 3.16

gtk_label_set_yalign ()

void
gtk_label_set_yalign (GtkLabel *label,
                      gfloat yalign);

Устанавливает свойство “yalign” для label.

С момента: 3.16

gtk_label_set_ellipsize ()

void
gtk_label_set_ellipsize (GtkLabel *label,
                         PangoEllipsizeMode mode);

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

С момента: 2.6

gtk_label_set_width_chars ()

void
gtk_label_set_width_chars (GtkLabel *label,
                           gint n_chars);

Устанавливает желаемую ширину в символах для label в 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.

С момента: 2.6

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().

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, что означает перенос по границам слов.

С момента: 2.10

gtk_label_set_lines ()

void
gtk_label_set_lines (GtkLabel *label,
                     gint lines);

Устанавливает количество строк, до которого следует ограничивать обрёзанную, переносящую строку метку. Это не имеет эффекта, если метка не переносит строки или не обрезается. Установите это значение в -1, если вы не хотите ограничивать количество строк.

С момента: 3.10

gtk_label_get_layout_offsets ()

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

Получает координаты, где метка нарисует PangoLayout, представляющий текст в метке; полезно для преобразования событий мыши в координаты внутри PangoLayout, например, для выполнения какого-либо действия, если щелкнута какая-то часть метки. Конечно, вам нужно создать GtkEventBox для получения событий и поместить метку внутрь неё, так как метки не имеют окна (они возвращают FALSE от gtk_widget_get_has_window()). Помните, что при использовании функций PangoLayout вам необходимо преобразовывать в пиксели и из пикселей, используя PANGO_PIXELS() или PANGO_SCALE.

gtk_label_get_mnemonic_keyval ()

guint
gtk_label_get_mnemonic_keyval (GtkLabel *label);

Если для метки задан мнемонический ключ, эта функция возвращает keyval, используемый для мнемонического ускорителя. Если мнемонический ключ не задан, она возвращает GDK_KEY_VoidSymbol.

gtk_label_get_selectable ()

gboolean
gtk_label_get_selectable (GtkLabel *label);

Получает значение, установленное функцией gtk_label_set_selectable().

gtk_label_get_text ()

const gchar *
gtk_label_get_text (GtkLabel *label);

Извлекает текст из виджета метки, как он отображается на экране. Это не включает в себя встроенные подчеркивания, указывающие на мнемоники или Pango разметку. (См. gtk_label_get_label())

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 будет выбран в качестве виджета мнемоники. Например, если метка находится внутри кнопки или пункта меню, кнопка или пункт меню автоматически станут виджетом мнемоники и будут активированы мнемоникой.

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, то будет использовано окончание метки.

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 рядом с меткой) необходимо установить его явно с помощью этой функции.

Целевой виджет будет ускорен путём вызова сигнала GtkWidget::mnemonic-activate на нём. Обработчик этого сигнала по умолчанию активирует виджет, если нет конфликтов мнемоники, и иначе переключает фокус между конфликтующими виджетами.

gtk_label_set_selectable ()

void
gtk_label_set_selectable (GtkLabel *label,
                          gboolean setting);

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

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().

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)).

gtk_label_get_justify ()

GtkJustification
gtk_label_get_justify (GtkLabel *label);

Возвращает выравнивание метки. См. gtk_label_set_justify().

gtk_label_get_xalign ()

gfloat
gtk_label_get_xalign (GtkLabel *label);

Получает свойство “xalign” для label .

С момента: 3.16

gtk_label_get_yalign ()

gfloat
gtk_label_get_yalign (GtkLabel *label);

Получает свойство “yalign” для label .

С момента: 3.16

gtk_label_get_ellipsize ()

PangoEllipsizeMode
gtk_label_get_ellipsize (GtkLabel *label);

Возвращает позицию обрезания метки. См. gtk_label_set_ellipsize().

С момента: 2.6

gtk_label_get_width_chars ()

gint
gtk_label_get_width_chars (GtkLabel *label);

Возвращает желаемую ширину label в символах. См. gtk_label_set_width_chars().

С момента: 2.6

gtk_label_get_max_width_chars ()

gint
gtk_label_get_max_width_chars (GtkLabel *label);

Возвращает желаемую максимальную ширину label в символах. См. gtk_label_set_width_chars().

С момента: 2.6

gtk_label_get_label ()

const gchar *
gtk_label_get_label (GtkLabel *label);

Извлекает текст из виджета метки, включая любые встроенные подчеркивания, указывающие на мнемоники, и Pango разметку. (См. gtk_label_get_text()).

gtk_label_get_layout ()

PangoLayout *
gtk_label_get_layout (GtkLabel *label);

Получает PangoLayout, используемый для отображения метки. Макет полезен, например, для преобразования позиций текста в пиксельные позиции в сочетании с gtk_label_get_layout_offsets(). Возвращаемый макет принадлежит label, поэтому его не нужно освобождать вызывающей стороне. label свободен повторно создавать свой макет в любое время, поэтому его следует рассматривать как только для чтения.

gtk_label_get_line_wrap ()

gboolean
gtk_label_get_line_wrap (GtkLabel *label);

Возвращает, автоматически ли метка переносит строки. См. gtk_label_set_line_wrap().

gtk_label_get_line_wrap_mode ()

PangoWrapMode
gtk_label_get_line_wrap_mode (GtkLabel *label);

Возвращает режим переноса строк, используемый меткой. См. gtk_label_set_line_wrap_mode().

С момента: 2.10

gtk_label_get_lines ()

gint
gtk_label_get_lines (GtkLabel *label);

Получает количество строк, до которых должна быть ограничена переносимая, обрезанная метка. См. gtk_label_set_lines().

С момента: 3.10

gtk_label_get_mnemonic_widget ()

GtkWidget *
gtk_label_get_mnemonic_widget (GtkLabel *label);

Возвращает целевой виджет мнемоники (горячей клавиши) этой метки. См. gtk_label_set_mnemonic_widget().

gtk_label_get_selection_bounds ()

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

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

gtk_label_get_use_markup ()

gboolean
gtk_label_get_use_markup (GtkLabel *label);

Возвращает, интерпретируется ли текст метки как разметка с помощью языка разметки текста Pango. См. gtk_label_set_use_markup().

gtk_label_get_use_underline ()

gboolean
gtk_label_get_use_underline (GtkLabel *label);

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

gtk_label_get_single_line_mode ()

gboolean
gtk_label_get_single_line_mode (GtkLabel *label);

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

С: 2.6

gtk_label_get_angle ()

gdouble
gtk_label_get_angle (GtkLabel *label);

Получает угол поворота метки. См. gtk_label_set_angle().

С: 2.6

gtk_label_set_label ()

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

Устанавливает текст метки. Метка интерпретируется как содержащая встроенные подчёркивания и/или разметку Pango в зависимости от значений свойств “use-underline” и “use-markup”.

gtk_label_set_use_markup ()

void
gtk_label_set_use_markup (GtkLabel *label,
                          gboolean setting);

Устанавливает, содержит ли текст метки разметку в языке разметки текста Pango. См. gtk_label_set_markup().

gtk_label_set_use_underline ()

void
gtk_label_set_use_underline (GtkLabel *label,
                             gboolean setting);

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

gtk_label_set_single-line-mode ()

void
gtk_label_set_single_line_mode (GtkLabel *label,
                                gboolean single_line_mode);

Устанавливает, находится ли метка в режиме одной строки.

С: 2.6

gtk_label_set_angle ()

void
gtk_label_set_angle (GtkLabel *label,
                     gdouble angle);

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

С: 2.6

gtk_label_get_current_uri ()

const gchar *
gtk_label_get_current_uri (GtkLabel *label);

Возвращает URI для активной ссылки в метке. Активная ссылка — это ссылка под указателем мыши или, в случае выбираемой метки, ссылка, в которой в настоящее время находится текстовый курсор.

Эта функция предназначена для использования в обработчике сигнала “activate-link” или для использования в обработчике сигнала “query-tooltip”.

С: 2.18

gtk_label_set_track_visited_links ()

void
gtk_label_set_track_visited_links (GtkLabel *label,
                                   gboolean track_links);

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

Since: 2.18

gtk_label_get_track_visited_links ()

gboolean
gtk_label_get_track_visited_links (GtkLabel *label);

Возвращает, отслеживает ли метка в настоящее время нажатые ссылки.

Since: 2.18