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.20/GtkLinkButton.html
