|  |  | GTK+ Reference Manual |
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