2006-03-30 15:49:22 +00:00
|
|
|
<!-- ##### SECTION Title ##### -->
|
|
|
|
GtkLinkButton
|
|
|
|
|
|
|
|
<!-- ##### SECTION Short_Description ##### -->
|
|
|
|
Create buttons bound to a URL
|
|
|
|
|
|
|
|
<!-- ##### SECTION Long_Description ##### -->
|
|
|
|
<para>
|
|
|
|
A #GtkLinkButton is a #GtkButton with a hyperlink, similar to the one
|
|
|
|
used by web browsers, which triggers an action when clicked. It is useful
|
|
|
|
to show quick links to resources.
|
|
|
|
</para>
|
|
|
|
|
|
|
|
<para>
|
|
|
|
A link button is created by calling either gtk_link_button_new() or
|
|
|
|
gtk_link_button_new_with_label(). If using the former, the URI you pass
|
|
|
|
to the constructor is used as a label for the widget.
|
|
|
|
</para>
|
|
|
|
|
|
|
|
<para>
|
|
|
|
The URI bound to a #GtkLinkButton can be set specifically using
|
|
|
|
gtk_link_button_set_uri(), and retrieved using gtk_link_button_get_uri().
|
|
|
|
</para>
|
|
|
|
|
|
|
|
<para>
|
|
|
|
#GtkLinkButton offers a global hook, which is called when the used clicks
|
|
|
|
on it: see gtk_link_button_set_uri_hook().
|
|
|
|
</para>
|
|
|
|
|
|
|
|
<para>
|
|
|
|
#GtkLinkButton was added in GTK+ 2.10.
|
|
|
|
</para>
|
|
|
|
|
|
|
|
<!-- ##### SECTION See_Also ##### -->
|
|
|
|
<para>
|
|
|
|
#GtkButton
|
|
|
|
</para>
|
|
|
|
|
|
|
|
<!-- ##### SECTION Stability_Level ##### -->
|
|
|
|
|
|
|
|
|
|
|
|
<!-- ##### STRUCT GtkLinkButton ##### -->
|
|
|
|
<para>
|
|
|
|
The #GtkLinkButton struct contains private data only, and should be
|
|
|
|
manipulated using the functions below.
|
|
|
|
</para>
|
|
|
|
|
|
|
|
|
|
|
|
<!-- ##### ARG GtkLinkButton:uri ##### -->
|
|
|
|
<para>
|
|
|
|
|
|
|
|
</para>
|
|
|
|
|
2008-08-19 01:17:29 +00:00
|
|
|
<!-- ##### ARG GtkLinkButton:visited ##### -->
|
|
|
|
<para>
|
|
|
|
|
|
|
|
</para>
|
|
|
|
|
2006-03-30 15:49:22 +00:00
|
|
|
<!-- ##### FUNCTION gtk_link_button_new ##### -->
|
|
|
|
<para>
|
|
|
|
|
|
|
|
</para>
|
|
|
|
|
|
|
|
@uri:
|
|
|
|
@Returns:
|
|
|
|
|
|
|
|
|
|
|
|
<!-- ##### FUNCTION gtk_link_button_new_with_label ##### -->
|
|
|
|
<para>
|
|
|
|
|
|
|
|
</para>
|
|
|
|
|
|
|
|
@uri:
|
|
|
|
@label:
|
|
|
|
@Returns:
|
|
|
|
|
|
|
|
|
|
|
|
<!-- ##### FUNCTION gtk_link_button_get_uri ##### -->
|
|
|
|
<para>
|
|
|
|
|
|
|
|
</para>
|
|
|
|
|
|
|
|
@link_button:
|
|
|
|
@Returns:
|
|
|
|
|
|
|
|
|
|
|
|
<!-- ##### FUNCTION gtk_link_button_set_uri ##### -->
|
|
|
|
<para>
|
|
|
|
|
|
|
|
</para>
|
|
|
|
|
|
|
|
@link_button:
|
|
|
|
@uri:
|
|
|
|
|
|
|
|
|
|
|
|
<!-- ##### USER_FUNCTION GtkLinkButtonUriFunc ##### -->
|
|
|
|
<para>
|
|
|
|
The type of a function which is called when the #GtkLinkButton is
|
|
|
|
clicked.
|
|
|
|
</para>
|
|
|
|
|
|
|
|
@button: the #GtkLinkButton which was clicked
|
2007-06-06 13:40:24 +00:00
|
|
|
@link_:
|
2007-05-27 02:32:21 +00:00
|
|
|
@user_data: user data that was passed when the function was registered
|
2006-03-30 15:49:22 +00:00
|
|
|
with gtk_link_button_set_uri_hook()
|
2007-06-06 13:40:24 +00:00
|
|
|
<!-- # Unused Parameters # -->
|
|
|
|
@link: the URI to which the clicked #GtkLinkButton points
|
2006-03-30 15:49:22 +00:00
|
|
|
|
|
|
|
|
|
|
|
<!-- ##### FUNCTION gtk_link_button_set_uri_hook ##### -->
|
|
|
|
<para>
|
|
|
|
|
|
|
|
</para>
|
|
|
|
|
|
|
|
@func:
|
|
|
|
@data:
|
|
|
|
@destroy:
|
|
|
|
@Returns:
|
|
|
|
|
|
|
|
|
2008-09-04 16:56:51 +00:00
|
|
|
<!-- ##### FUNCTION gtk_link_button_get_visited ##### -->
|
|
|
|
<para>
|
|
|
|
|
|
|
|
</para>
|
|
|
|
|
|
|
|
@link_button:
|
|
|
|
@Returns:
|
|
|
|
|
|
|
|
|
|
|
|
<!-- ##### FUNCTION gtk_link_button_set_visited ##### -->
|
|
|
|
<para>
|
|
|
|
|
|
|
|
</para>
|
|
|
|
|
|
|
|
@link_button:
|
|
|
|
@visited:
|
|
|
|
|
|
|
|
|