~ubuntu-branches/ubuntu/precise/gtk+2.0/precise-updates

« back to all changes in this revision

Viewing changes to docs/reference/gtk/tmpl/gtklinkbutton.sgml

  • Committer: Package Import Robot
  • Author(s): Ken VanDine
  • Date: 2011-12-01 11:40:06 UTC
  • mfrom: (1.14.11)
  • Revision ID: package-import@ubuntu.com-20111201114006-nrmf6qu3pg512veo
Tags: 2.24.8-0ubuntu1
* New upstream release 
  - gtkfilechooser should be more robust to malformed URIs
    in .gtk-bookmarks (LP: #189494)
* debian/patches/010_make_bg_changes_queue_repaint.patch
  - dropped it introduces performance regressions in some gtk2 
    apps (LP: #889019)
* 101_filechooser.patch, 000git_file_chooser.patch: dropped, upstream

Show diffs side-by-side

added added

removed removed

Lines of Context:
1
 
<!-- ##### SECTION Title ##### -->
2
 
GtkLinkButton
3
 
 
4
 
<!-- ##### SECTION Short_Description ##### -->
5
 
Create buttons bound to a URL
6
 
 
7
 
<!-- ##### SECTION Long_Description ##### -->
8
 
<para>
9
 
A #GtkLinkButton is a #GtkButton with a hyperlink, similar to the one
10
 
used by web browsers, which triggers an action when clicked. It is useful
11
 
to show quick links to resources.
12
 
</para>
13
 
 
14
 
<para>
15
 
A link button is created by calling either gtk_link_button_new() or
16
 
gtk_link_button_new_with_label(). If using the former, the URI you pass
17
 
to the constructor is used as a label for the widget.
18
 
</para>
19
 
 
20
 
<para>
21
 
The URI bound to a #GtkLinkButton can be set specifically using
22
 
gtk_link_button_set_uri(), and retrieved using gtk_link_button_get_uri().
23
 
</para>
24
 
 
25
 
<para>
26
 
#GtkLinkButton offers a global hook, which is called when the used clicks
27
 
on it: see gtk_link_button_set_uri_hook().
28
 
</para>
29
 
 
30
 
<para>
31
 
#GtkLinkButton was added in GTK+ 2.10.
32
 
</para>
33
 
 
34
 
<!-- ##### SECTION See_Also ##### -->
35
 
<para>
36
 
#GtkButton
37
 
</para>
38
 
 
39
 
<!-- ##### SECTION Stability_Level ##### -->
40
 
 
41
 
 
42
 
<!-- ##### SECTION Image ##### -->
43
 
 
44
 
 
45
 
<!-- ##### STRUCT GtkLinkButton ##### -->
46
 
<para>
47
 
The #GtkLinkButton struct contains private data only, and should be
48
 
manipulated using the functions below.
49
 
</para>
50
 
 
51
 
 
52
 
<!-- ##### ARG GtkLinkButton:uri ##### -->
53
 
<para>
54
 
 
55
 
</para>
56
 
 
57
 
<!-- ##### ARG GtkLinkButton:visited ##### -->
58
 
<para>
59
 
 
60
 
</para>
61
 
 
62
 
<!-- ##### FUNCTION gtk_link_button_new ##### -->
63
 
<para>
64
 
 
65
 
</para>
66
 
 
67
 
@uri: 
68
 
@Returns: 
69
 
 
70
 
 
71
 
<!-- ##### FUNCTION gtk_link_button_new_with_label ##### -->
72
 
<para>
73
 
 
74
 
</para>
75
 
 
76
 
@uri: 
77
 
@label: 
78
 
@Returns: 
79
 
 
80
 
 
81
 
<!-- ##### FUNCTION gtk_link_button_get_uri ##### -->
82
 
<para>
83
 
 
84
 
</para>
85
 
 
86
 
@link_button: 
87
 
@Returns: 
88
 
 
89
 
 
90
 
<!-- ##### FUNCTION gtk_link_button_set_uri ##### -->
91
 
<para>
92
 
 
93
 
</para>
94
 
 
95
 
@link_button: 
96
 
@uri: 
97
 
 
98
 
 
99
 
<!-- ##### USER_FUNCTION GtkLinkButtonUriFunc ##### -->
100
 
<para>
101
 
The type of a function which is called when the #GtkLinkButton is
102
 
clicked.
103
 
</para>
104
 
 
105
 
@button: the #GtkLinkButton which was clicked
106
 
@link_: the URI to which the clicked #GtkLinkButton points
107
 
@user_data: user data that was passed when the function was registered
108
 
  with gtk_link_button_set_uri_hook()
109
 
 
110
 
 
111
 
<!-- ##### FUNCTION gtk_link_button_set_uri_hook ##### -->
112
 
<para>
113
 
 
114
 
</para>
115
 
 
116
 
@func: 
117
 
@data: 
118
 
@destroy: 
119
 
@Returns: 
120
 
 
121
 
 
122
 
<!-- ##### FUNCTION gtk_link_button_get_visited ##### -->
123
 
<para>
124
 
 
125
 
</para>
126
 
 
127
 
@link_button: 
128
 
@Returns: 
129
 
 
130
 
 
131
 
<!-- ##### FUNCTION gtk_link_button_set_visited ##### -->
132
 
<para>
133
 
 
134
 
</para>
135
 
 
136
 
@link_button: 
137
 
@visited: 
138
 
 
139