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 .

Since: 3.16

gtk_label_get_yalign ()

gfloat
gtk_label_get_yalign (GtkLabel *label);

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

Since: 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);

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

С версии: 2.18

gtk_label_get_track_visited-links ()

gboolean
gtk_label_get_track_visited_links (GtkLabel *label);

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

С версии: 2.18

Свойство “angle”

  “angle”                    double

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

Владелец: GtkLabel

Флаги: Чтение / Запись

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

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

С версии: 2.6

Свойство “attributes”

  “attributes”               PangoAttrList *

Список атрибутов стиля, которые нужно применить к тексту метки.

Владелец: GtkLabel

Флаги: Чтение / Запись

Свойство “cursor-position”

  “cursor-position”          int

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

Владелец: GtkLabel

Флаги: Чтение

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

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

Свойство “ellipsize”

  “ellipsize”                PangoEllipsizeMode

Предпочтительное место для обрезки строки, если метка не имеет достаточно места для отображения всей строки, задается как PangoEllipsizeMode.

Обратите внимание, что установка этого свойства на значение, отличное от PANGO_ELLIPSIZE_NONE, приводит к тому, что метка запрашивает только достаточно места для отображения многоточия «...». В частности, это означает, что обрезка меток плохо работает во вкладках книжных полок, если свойство расширения вкладки GtkNotebook не установлено в TRUE. Другие способы задания ширины метки — gtk_widget_set_size_request() и gtk_label_set_width_chars().

Владелец: GtkLabel

Флаги: Чтение / Запись

Значение по умолчанию: PANGO_ELLIPSIZE_NONE

С версии: 2.6

Свойство “justify”

  “justify”                  GtkJustification

Выравнивание строк текста метки относительно друг друга. Это НЕ влияет на выравнивание метки в ее области размещения. Для этого используйте GtkLabel:xalign.

Владелец: GtkLabel

Флаги: Чтение / Запись

Значение по умолчанию: GTK_JUSTIFY_LEFT

Свойство “label”

  “label”                    char *

Содержимое метки.

Если строка содержит разметку Pango XML, необходимо установить свойство “use-markup” в TRUE для отображения атрибутов разметки. Также см. gtk_label_set_markup() — удобную функцию, которая устанавливает сразу это свойство и свойство “use-markup”.

Если строка содержит подчеркнутые символы, используемые в качестве мнемоник, необходимо установить свойство “use-underline” в TRUE для их отображения.

Владелец: GtkLabel

Флаги: Чтение / Запись

Значение по умолчанию: ""

Свойство “lines”

  “lines”                    int

Количество строк, до которых должна быть ограничена обрезка или перенос текста в метке. Это свойство не влияет, если метка не выполняет перенос или обрезку. Установите значение -1, если не нужно ограничивать количество строк.

Владелец: GtkLabel

Флаги: Чтение / Запись

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

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

С версии: 3.10

Свойство “max-width-chars”

  “max-width-chars”          int

Желаемая максимальная ширина метки в символах. Если это свойство установлено в -1, ширина будет вычислена автоматически.

См. раздел размещение текста для получения подробной информации о том, как “width-chars” и “max-width-chars” определяют ширину обрезки и переноса строк в метках.

Владелец: GtkLabel

Флаги: Чтение / Запись

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

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

С версии: 2.6

Свойство “mnemonic-keyval”

  “mnemonic-keyval”          guint

Мнемоническая клавиша-акселератор для этой метки.

Владелец: GtkLabel

Флаги: Чтение

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

Свойство “mnemonic-widget”

  “mnemonic-widget”          GtkWidget *

Элемент управления, который будет активирован при нажатии мнемонической клавиши метки.

Владелец: GtkLabel

Флаги: Чтение / Запись

Свойство “pattern”

  “pattern”                  char *

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

Владелец: GtkLabel

Флаги: Запись

Значение по умолчанию: NULL

Свойство “selectable”

  “selectable”               gboolean

Можно ли выбрать текст метки с помощью мыши.

Владелец: GtkLabel

Флаги: Чтение / Запись

Значение по умолчанию: FALSE

Свойство “selection-bound”

  “selection-bound”          int

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

Владелец: GtkLabel

Флаги: Чтение

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

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

Свойство “single-line-mode”

  “single-line-mode”         gboolean

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

Владелец: GtkLabel

Флаги: Чтение / Запись

Значение по умолчанию: FALSE

С версии: 2.6

Свойство “track-visited-links”

  “track-visited-links”      gboolean

Установите это свойство в TRUE для отслеживания посещенных ссылок в метке. Тогда при отрисовке ссылки будет применяться GTK_STATE_FLAG_VISITED в дополнение к GTK_STATE_FLAG_LINK.

Владелец: GtkLabel

Флаги: Чтение / Запись

Значение по умолчанию: TRUE

С версии: 2.18

Свойство “use-markup”

  “use-markup”               gboolean

Текст метки включает разметку XML. См. pango_parse_markup().

Владелец: GtkLabel

Флаги: Чтение / Запись

Значение по умолчанию: FALSE

Свойство “use-underline”

  “use-underline”            gboolean

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

Владелец: GtkLabel

Флаги: Чтение / Запись

Значение по умолчанию: FALSE

Свойство “width-chars”

  “width-chars”              int

Желаемая ширина метки в символах. Если это свойство установлено в -1, ширина будет вычислена автоматически.

См. раздел размещение текста для получения подробной информации о том, как “width-chars” и “max-width-chars” определяют ширину обрезки и переноса строк в метках.

Владелец: GtkLabel

Флаги: Чтение / Запись

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

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

С версии: 2.6

Свойство “wrap”

  “wrap”                     gboolean

Если установлено, строки переносятся, если текст становится слишком широким.

Владелец: GtkLabel

Флаги: Чтение / Запись

Значение по умолчанию: FALSE

Свойство “wrap-mode”

  “wrap-mode”                PangoWrapMode

Если перенос строк включен (см. свойство “wrap”), это свойство определяет, как выполняется перенос строк. По умолчанию используется PANGO_WRAP_WORD, что означает перенос по границам слов.

Владелец: GtkLabel

Флаги: Чтение / Запись

Значение по умолчанию: PANGO_WRAP_WORD

С версии: 2.10

Свойство “xalign”

  “xalign”                   float

Свойство xalign определяет горизонтальное выравнивание текста метки внутри области размещения метки. Сравните это со свойством “halign”, которое определяет, как область размещения метки размещается в доступном пространстве для метки.

Владелец: GtkLabel

Флаги: Чтение / Запись

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

Значение по умолчанию: 0.5

С версии: 3.16

Свойство “yalign”

  “yalign”                   float

Свойство yalign определяет вертикальное выравнивание текста метки внутри выделенной области метки. Сравните это с “valign”, которое определяет, как область размещения метки позиционируется в доступном пространстве для метки.

Владелец: GtkLabel

Флаги: Чтение / Запись

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

Значение по умолчанию: 0.5

С версии: 3.16