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

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

Since: 2.6

gtk_label_get_angle ()

gdouble
gtk_label_get_angle (GtkLabel *label);

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

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

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

gtk_label_set_single_line_mode ()

void
gtk_label_set_single_line_mode (GtkLabel *label,
                                gboolean single_line_mode);

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

Since: 2.6

gtk_label_set_angle ()

void
gtk_label_set_angle (GtkLabel *label,
                     gdouble angle);

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

Since: 2.6

gtk_label_get_current_uri ()

const gchar *
gtk_label_get_current_uri (GtkLabel *label);

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

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

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