GtkLinkButton
GtkLinkButton — Создание кнопок, связанных с URL
Функции
| GtkWidget * | gtk_link_button_new () |
| GtkWidget * | gtk_link_button_new_with_label () |
| const char * | 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 | Выполняется последним |
Действия
| menu.popup | ||
| clipboard.copy |
Типы и значения
Реализованные интерфейсы
GtkLinkButton реализует GtkAccessible, GtkBuildable, GtkConstraintTarget и GtkActionable.
Файлы заголовков
#include <gtk/gtk.h>
Описание
GtkLinkButton — это GtkButton с гиперссылкой, похожей на используемые в веб-браузерах, которая запускает действие при нажатии. Она полезна для отображения быстрых ссылок на ресурсы.
Кнопка ссылки создаётся путём вызова либо gtk_link_button_new(), либо gtk_link_button_new_with_label(). При использовании первого варианта, URL, переданный в конструктор, используется в качестве метки виджета.
URL, привязанный к GtkLinkButton, можно задать конкретно с помощью gtk_link_button_set_uri(), и получить с помощью gtk_link_button_get_uri().
По умолчанию GtkLinkButton вызывает gtk_show_uri() при нажатии на кнопку. Это поведение можно переопределить, подключившись к сигналу “activate-link” и вернув значение TRUE в обработчике сигнала.
Элементы CSS
GtkLinkButton имеет один CSS-узел с именем button. Чтобы отличить его от обычной GtkButton, он получает класс стиля .link.
Доступность
GtkLinkButton использует роль GTK_ACCESSIBLE_ROLE_LINK.
Подробное описание функций
gtk_link_button_new ()
GtkWidget *
gtk_link_button_new (const char *uri); Создаёт новую кнопку GtkLinkButton с URL в качестве текста.
Параметры
uri | действительный URL |
Возвращаемое значение
новый виджет кнопки ссылки.
gtk_link_button_new_with_label ()
GtkWidget * gtk_link_button_new_with_label (const char *uri,const char *label);
Создаёт новую GtkLinkButton с меткой.
Параметры
uri | действительный URL | |
label | текст кнопки. | [allow-none] |
Возвращаемое значение
новый виджет кнопки ссылки.
[transfer none]
gtk_link_button_get_uri ()
const char *
gtk_link_button_get_uri (GtkLinkButton *link_button); Возвращает URL, установленный с помощью gtk_link_button_set_uri().
Параметры
link_button | GtkLinkButton |
Возвращаемое значение
действительный URL. Возвращённая строка принадлежит кнопке ссылки и не должна быть изменена или освобождена.
gtk_link_button_set_uri ()
void gtk_link_button_set_uri (GtkLinkButton *link_button,const char *uri);
Устанавливает uri в качестве URI, на который указывает GtkLinkButton. В качестве побочного эффекта, состояние «посещённый» кнопки сбрасывается.
Параметры
link_button | GtkLinkButton | |
uri | действительный URL |
gtk_link_button_get_visited ()
gboolean
gtk_link_button_get_visited (GtkLinkButton *link_button); Возвращает состояние «посещённый» URL, на который указывает GtkLinkButton. Кнопка становится посещённой при нажатии. Если URL кнопки изменяется, состояние «посещённый» сбрасывается.
Состояние также может быть изменено с помощью gtk_link_button_set_visited().
Параметры
link_button | GtkLinkButton |
Возвращаемое значение
TRUE если ссылка посещена, FALSE в противном случае
gtk_link_button_set_visited ()
void gtk_link_button_set_visited (GtkLinkButton *link_button,gboolean visited);
Устанавливает состояние «посещённый» URL, на который указывает GtkLinkButton. См. gtk_link_button_get_visited() для получения дополнительной информации.
Параметры
link_button | GtkLinkButton | |
visited | новое состояние «посещённый» |
Подробное описание типов и значений
GtkLinkButton
typedef struct _GtkLinkButton GtkLinkButton;
Подробное описание свойств
Свойство “uri”
“uri” char *
URI, привязанный к этой кнопке.
Владелец: GtkLinkButton
Флаги: Чтение / Запись
Значение по умолчанию: NULL
Свойство “visited”
“visited” gboolean
Состояние «посещённой» ссылки этой кнопки. Посещённая ссылка отображается другим цветом.
Владелец: GtkLinkButton
Флаги: Чтение / Запись
Значение по умолчанию: FALSE
Подробное описание сигналов
Сигнал “activate-link”
gboolean user_function (GtkLinkButton *button, gpointer user_data)
Сигнал ::activate-link генерируется каждый раз, когда кнопка GtkLinkButton нажимается.
Обработчик по умолчанию вызовет gtk_show_uri() с URI, хранящимся в свойстве “uri”.
Чтобы переопределить стандартное поведение, можно подключиться к сигналу ::activate-link и остановить распространение сигнала, вернув TRUE из своего обработчика.
Параметры
button | кнопка GtkLinkButton, которая сгенерировала сигнал | |
user_data | данные пользователя, заданные при подключении обработчика сигнала. |
Флаги: Выполнять последним
Подробное описание действий
Действие “menu.popup”
Открывает контекстное меню.
Действие “clipboard.copy”
Копирует URL в буфер обмена.
См. также
© 2005–2020 The GNOME Project
Licensed under the GNU Lesser General Public License version 2.1 or later.
https://developer-old.gnome.org/gtk4/4.0/GtkLinkButton.html
