← Back to branch summary

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

« back to all changes in this revision

Viewing changes to docs/reference/gtk/tmpl/gtkhbbox.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
https://launchpad.net/bugs/189494
https://launchpad.net/bugs/889019
* 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:
docs/reference/gtk/tmpl/gtkhbbox.sgml
1
 
<!-- ##### SECTION Title ##### -->
2
 
GtkHButtonBox
3
 
 
4
 
<!-- ##### SECTION Short_Description ##### -->
5
 
A container for arranging buttons horizontally
6
 
 
7
 
<!-- ##### SECTION Long_Description ##### -->
8
 
<para>
9
 
A button box should be used to provide a consistent layout of buttons
10
 
throughout your application. The layout/spacing can be altered by the
11
 
programmer, or if desired, by the user to alter the 'feel' of a
12
 
program to a small degree.
13
 
</para>
14
 
<para>
15
 
A #GtkHButtonBox is created with gtk_hbutton_box_new(). Buttons are
16
 
packed into a button box the same way widgets are added to any other
17
 
container, using gtk_container_add(). You can also use
18
 
gtk_box_pack_start() or gtk_box_pack_end(), but for button boxes both
19
 
these functions work just like gtk_container_add(), ie., they pack the
20
 
button in a way that depends on the current layout style and on
21
 
whether the button has had gtk_button_box_set_child_secondary() called
22
 
on it.
23
 
</para>
24
 
 
25
 
<para>
26
 
The spacing between buttons can be set with gtk_box_set_spacing(). The
27
 
arrangement and layout of the buttons can be changed with
28
 
gtk_button_box_set_layout().
29
 
</para>
30
 
 
31
 
<!-- ##### SECTION See_Also ##### -->
32
 
<para>
33
 
<variablelist>
34
 
<varlistentry>
35
 
<term>#GtkBox</term>
36
 
<listitem><para>Used to pack widgets into button boxes.</para></listitem>
37
 
</varlistentry><varlistentry>
38
 
<term>#GtkButtonBox</term>
39
 
<listitem><para>Provides functions for controlling button boxes.</para></listitem>
40
 
</varlistentry>
41
 
<varlistentry>
42
 
<term>#GtkVButtonBox</term>
43
 
<listitem><para>Pack buttons vertically</para></listitem>
44
 
</varlistentry>
45
 
</variablelist>
46
 
</para>
47
 
 
48
 
<!-- ##### SECTION Stability_Level ##### -->
49
 
 
50
 
 
51
 
<!-- ##### SECTION Image ##### -->
52
 
 
53
 
 
54
 
<!-- ##### STRUCT GtkHButtonBox ##### -->
55
 
<para>
56
 
GtkHButtonBox does not contain any public fields.
57
 
</para>
58
 
 
59
 
 
60
 
<!-- ##### FUNCTION gtk_hbutton_box_new ##### -->
61
 
<para>
62
 
Creates a new horizontal button box.
63
 
</para>
64
 
 
65
 
@void: 
66
 
@Returns: a new button box #GtkWidget.
67
 
 
68
 
 
69
 
<!-- ##### FUNCTION gtk_hbutton_box_get_spacing_default ##### -->
70
 
<para>
71
 
Retrieves the current default spacing for horizontal button boxes. This is the number of pixels 
72
 
to be placed between the buttons when they are arranged.
73
 
</para>
74
 
 
75
 
@void: 
76
 
@Returns: the default number of pixels between buttons.
77
 
 
78
 
 
79
 
<!-- ##### FUNCTION gtk_hbutton_box_get_layout_default ##### -->
80
 
<para>
81
 
Retrieves the current layout used to arrange buttons in button box widgets.
82
 
</para>
83
 
 
84
 
@void: 
85
 
@Returns: the current #GtkButtonBoxStyle.
86
 
 
87
 
 
88
 
<!-- ##### FUNCTION gtk_hbutton_box_set_spacing_default ##### -->
89
 
<para>
90
 
Changes the default spacing that is placed between widgets in an
91
 
horizontal button box.
92
 
</para>
93
 
 
94
 
@spacing: an integer value.
95
 
 
96
 
 
97
 
<!-- ##### FUNCTION gtk_hbutton_box_set_layout_default ##### -->
98
 
<para>
99
 
Sets a new layout mode that will be used by all button boxes.
100
 
</para>
101
 
 
102
 
@layout: a new #GtkButtonBoxStyle.
103
 
 
104