GtkLinkButton
GtkLinkButton — Создание кнопок, связанных с URL
Функции
| GtkWidget * | gtk_link_button_new () |
| GtkWidget * | gtk_link_button_new_with_label () |
| const gchar * | gtk_link_button_get_uri () |
| void | gtk_link_button_set_uri () |
| gboolean | gtk_link_button_get_visited () |
| void | gtk_link_button_set_visited () |
Сигналы
| gboolean | activate-link | Выполнить последним |
Типы и значения
| struct | GtkLinkButton |
| struct | GtkLinkButtonClass |
Иерархия объектов
GObject
╰── GInitiallyUnowned
╰── GtkWidget
╰── GtkContainer
╰── GtkBin
╰── GtkButton
╰── GtkLinkButton
Реализованные интерфейсы
GtkLinkButton реализует AtkImplementorIface, GtkBuildable, GtkActionable и GtkActivatable.
Включения
#include <gtk/gtk.h>
Описание
GtkLinkButton — это GtkButton с гиперссылкой, похожей на ту, что используется в веб-браузерах, которая запускает действие при нажатии. Полезно для отображения быстрых ссылок на ресурсы.
Кнопка ссылки создается с помощью вызова gtk_link_button_new() или gtk_link_button_new_with_label(). Если используется первый вариант, переданный в конструктор URL используется как метка виджета.
Связанный с GtkLinkButton URL может быть установлен конкретно с помощью gtk_link_button_set_uri() и получен с помощью gtk_link_button_get_uri().
По умолчанию GtkLinkButton вызывает gtk_show_uri_on_window() при нажатии на кнопку. Это поведение можно переопределить, подключившись к сигналу “activate-link” и вернув TRUE из обработчика сигнала.
CSS-узлы
GtkLinkButton имеет один CSS-узел с именем button. Для его отличия от обычной GtkButton он получает класс стиля .link.
Функции
gtk_link_button_new ()
GtkWidget *
gtk_link_button_new (const gchar *uri); Создаёт новую кнопку GtkLinkButton с URI в качестве текста.
Параметры
uri | действительный URI |
Возвращает
новый виджет кнопки ссылки.
С: 2.10
gtk_link_button_new_with_label ()
GtkWidget * gtk_link_button_new_with_label (const gchar *uri,const gchar *label);
Создаёт новую GtkLinkButton с меткой.
Параметры
uri | действительный URI | |
label | текст кнопки. | [allow-none] |
Возвращает
новый виджет кнопки ссылки.
[transfer none]
С: 2.10
gtk_link_button_get_uri ()
const gchar *
gtk_link_button_get_uri (GtkLinkButton *link_button); Возвращает URI, заданный с помощью gtk_link_button_set_uri().
Параметры
link_button | кнопка GtkLinkButton |
Возвращает
действительный URI. Возвращённая строка принадлежит кнопке ссылки и не должна изменяться или освобождаться.
С: 2.10
gtk_link_button_set_uri ()
void gtk_link_button_set_uri (GtkLinkButton *link_button,const gchar *uri);
Устанавливает uri в качестве URI, на который указывает GtkLinkButton. В качестве побочного эффекта это сбрасывает состояние «посещённость» кнопки.
Параметры
link_button | кнопка GtkLinkButton | |
uri | действительный URI |
С: 2.10
gtk_link_button_get_visited ()
gboolean
gtk_link_button_get_visited (GtkLinkButton *link_button); Возвращает состояние «посещённость» URI, на который указывает GtkLinkButton. Кнопка становится посещённой, когда на неё нажимают. Если URI на кнопке изменяется, состояние «посещённость» сбрасывается.
Состояние также можно изменить с помощью gtk_link_button_set_visited().
Параметры
link_button | кнопка GtkLinkButton |
Возвращает
TRUE если ссылка посещена, FALSE в противном случае
С: 2.14
gtk_link_button_set_visited ()
void gtk_link_button_set_visited (GtkLinkButton *link_button,gboolean visited);
Устанавливает состояние «посещённость» URI, на который указывает GtkLinkButton. См. gtk_link_button_get_visited() для получения более подробной информации.
Параметры
link_button | кнопка GtkLinkButton | |
visited | новое состояние «посещённость» |
С: 2.14
Типы и значения
struct GtkLinkButton
struct GtkLinkButton;
Структура GtkLinkButton содержит только приватные данные и должна быть обработана с помощью предоставленного API.
struct GtkLinkButtonClass
struct GtkLinkButtonClass {
gboolean (* activate_link) (GtkLinkButton *button);
};
Структура GtkLinkButtonClass содержит только приватные данные.
Члены
| обработчик класса для сигнала “activate-link” |
Подробное описание свойств
Свойство “uri”
“uri” char *
URI, привязанный к этой кнопке.
Владелец: GtkLinkButton
Флаги: Чтение / Запись
Значение по умолчанию: NULL
С: 2.10
Свойство “visited”
“visited” gboolean
Состояние «посещённость» этой кнопки. Посещённая ссылка отображается в другом цвете.
Владелец: GtkLinkButton
Флаги: Чтение / Запись
Значение по умолчанию: FALSE
С: 2.14
Подробное описание сигналов
Сигнал “activate-link”
gboolean user_function (GtkLinkButton *button, gpointer user_data)
Сигнал ::activate-link генерируется каждый раз, когда на GtkLinkButton нажимают.
Обработчик по умолчанию вызовет gtk_show_uri_on_window() с URI, сохранённым в свойстве “uri”.
Чтобы переопределить поведение по умолчанию, можно подключиться к сигналу ::activate-link и остановить распространение сигнала, вернув TRUE от вашего обработчика.
Параметры
button | кнопка GtkLinkButton, которая сгенерировала сигнал | |
user_data | пользовательские данные, заданные при подключении обработчика сигнала. |
Флаги: Run Last
См. также
© 2005–2020 The GNOME Project
Licensed under the GNU Lesser General Public License version 2.1 or later.
https://developer.gnome.org/gtk3/3.24/GtkLinkButton.html
