Prev

Up

Home

GTK+ Reference Manual

Next

Top  |  Description  |  Object Hierarchy  |  Properties

GtkLinkButton

GtkLinkButton Кнопки привязанные к URL

Краткое описание

#include <gtk/gtk.h> GtkLinkButton; GtkWidget* gtk_link_button_new (const gchar *uri); GtkWidget* gtk_link_button_new_with_label (const gchar *uri, const gchar *label); const gchar* gtk_link_button_get_uri (GtkLinkButton *link_button); void gtk_link_button_set_uri (GtkLinkButton *link_button, const gchar *uri); void (*GtkLinkButtonUriFunc) (GtkLinkButton *button, const gchar *link, gpointer user_data); GtkLinkButtonUriFunc gtk_link_button_set_uri_hook (GtkLinkButtonUriFunc func, gpointer data, GDestroyNotify destroy);

Иерархия объектов

GObject +----GInitiallyUnowned +----GtkObject +----GtkWidget +----GtkContainer +----GtkBin +----GtkButton +----GtkLinkButton

Осуществляемые интерфейсы

GtkLinkButton осуществляет AtkImplementorIface.

Свойства

  "uri"                  gchararray            : Read / Write

Описание

GtkLinkButton - это GtkButton с гиперссылкой, похожие на используемый в web-браузерах текст вызывающий действие при нажатии на нём. Это полезно для показа быстрых ссылок на ресурсы.

Кнопка ссылка создаётся одной из двух функций 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_link_button_set_uri_hook().

GtkLinkButton был добавлен в GTK+ 2.10.

Детали

GtkLinkButton

typedef struct _GtkLinkButton GtkLinkButton;

Структура GtkLinkButton содержит только закрытые данные которыми манипулируют функции описанные ниже.


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 :

текст кнопки

Возвращает:

новую кнопку ссылку.

Начиная с версии 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


GtkLinkButtonUriFunc ()

void (*GtkLinkButtonUriFunc) (GtkLinkButton *button, const gchar *link, gpointer user_data);

Тип функции которая вызывается при нажатии на GtkLinkButton.

button :

GtkLinkButton когда был нажат

link :

URI на который указывает нажатый GtkLinkButton

user_data :


gtk_link_button_set_uri_hook ()

GtkLinkButtonUriFunc gtk_link_button_set_uri_hook (GtkLinkButtonUriFunc func, gpointer data, GDestroyNotify destroy);

Устанавливает func как функцию вызываемую всегда, когда пользователь нажимает на GtkLinkButton. Эта функция вызывается перед всеми зарегистрированными для сигнала "clicked" обратными вызовами.

func :

Функция вызываемая всегда при нажатии на GtkLinkButton, или NULL

data :

Пользовательские данные помещаемые в func, или NULL

destroy :

GDestroyNotify который вызывается когда data больше не нужны, или NULL

Возвращает:

Предварительно установленная функция обработчика прерываний.

Начиная с версии 2.10

Детали свойств

Свойство "uri"

  "uri"                  gchararray            : Read / Write

URI к которому привязана кнопка.

Значение по умолчанию: "http://www.gtk.org"

Начиная с версии 2.10

Смотрите также

GtkButton