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 () |
Сигналы
Типы и значения
| 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(). Если используется первый вариант, URI, переданный конструктору, используется в качестве метки виджета.
URI, привязанный к GtkLinkButton, может быть задан непосредственно с помощью gtk_link_button_set_uri(), и получен с помощью gtk_link_button_get_uri().
По умолчанию GtkLinkButton вызывает gtk_show_uri() при нажатии кнопки. Это поведение можно переопределить, подключившись к сигналу “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 |
С: 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” gchar *
URI, привязанный к этой кнопке.
Флаги: Чтение / Запись
Значение по умолчанию: NULL
С: 2.10
Свойство “visited”
“visited” gboolean
Состояние 'посещённой' кнопки. Посещённая ссылка рисуется другим цветом.
Флаги: Чтение / Запись
Значение по умолчанию: FALSE
С: 2.14
Подробное описание сигналов
Сигнал “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 | пользовательские данные, установленные при подключении обработчика сигнала. |
Флаги: 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.22/GtkLinkButton.html
