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

#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 как текстом на кнопке.

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

gtk_link_button_new_with_label ()

gtkwidget*  gtk_link_button_new_with_label  (const gchar *uri,
                                             const gchar *label);

создаёт новый gtklinkbutton содержащий ярлык.

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

gtk_link_button_get_uri ()

const gchar* gtk_link_button_get_uri        (gtklinkbutton *link_button);

получает uri установленный функцией gtk_link_button_set_uri().

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

gtk_link_button_set_uri ()

void        gtk_link_button_set_uri         (gtklinkbutton *link_button,
                                             const gchar *uri);

устанавливает uri как uri куда указывает gtklinkbutton.

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

gtklinkbuttonurifunc ()

void        (*gtklinkbuttonurifunc)         (gtklinkbutton *button,
                                             const gchar *link,
                                             gpointer user_data);

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

gtk_link_button_set_uri_hook ()

gtklinkbuttonurifunc gtk_link_button_set_uri_hook
                                            (gtklinkbuttonurifunc func,
                                             gpointer data,
                                             gdestroynotify destroy);

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

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

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

свойство "uri"

  "uri"                  gchararray            : read / write

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

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

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

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

gtkbutton