summaryrefslogtreecommitdiff
path: root/docs/reference/gtk/tmpl/gtklinkbutton.sgml
blob: fb187137fabeb8fbcfc88b4fd26ad19fe9c485f2 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
<!-- ##### 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>

<!-- ##### 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
@link_: 
@user_data: 
<!-- # Unused Parameters # -->
@link: the URI to which the clicked #GtkLinkButton points
@data: user data that was passed when the function was registered
  with gtk_link_button_set_uri_hook()


<!-- ##### FUNCTION gtk_link_button_set_uri_hook ##### -->
<para>

</para>

@func: 
@data: 
@destroy: 
@Returns: