gtkfixed.sgml 3.53 KB
Newer Older
Owen Taylor's avatar
Owen Taylor committed
1 2 3 4
<!-- ##### SECTION Title ##### -->
GtkFixed

<!-- ##### SECTION Short_Description ##### -->
5
A container which allows you to position widgets at fixed coordinates
Owen Taylor's avatar
Owen Taylor committed
6 7 8 9

<!-- ##### SECTION Long_Description ##### -->
<para>
The #GtkFixed widget is a container which can place child widgets at fixed
Havoc Pennington's avatar
Havoc Pennington committed
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
positions and with fixed sizes, given in pixels. #GtkFixed performs no
automatic layout management.
</para>

<para>
For most applications, you should not use this container! It keeps
you from having to learn about the other GTK+ containers, but it
results in broken applications.
With #GtkFixed, the following things will result in truncated text, 
overlapping widgets, and other display bugs:
<itemizedlist>
<listitem>
<para>Themes, which may change widget sizes.
</para>
</listitem>
<listitem>
<para>Fonts other than the one you used to write the app will of
course change the size of widgets containing text; keep in mind that
users may use a larger font because of difficulty reading the default,
or they may be using Windows or the framebuffer port of GTK+, where
different fonts are available.
</para>
</listitem>
<listitem>
<para>
Translation of text into other languages changes its size. Also,
display of non-English text will use a different font in many cases.
</para>
</listitem>
</itemizedlist>
</para>
Owen Taylor's avatar
Owen Taylor committed
41

Havoc Pennington's avatar
Havoc Pennington committed
42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59
<para>
In addition, the fixed widget can't properly be mirrored in
right-to-left languages such as Hebrew and Arabic. i.e. normally GTK+
will flip the interface to put labels to the right of the thing they
label, but it can't do that with #GtkFixed. So your application will 
not be usable in right-to-left languages.
</para>

<para>
Finally, fixed positioning makes it kind of annoying to add/remove GUI
elements, since you have to reposition all the other elements. This is
a long-term maintenance problem for your application.
</para>

<para>
If you know none of these things are an issue for your application,
and prefer the simplicity of #GtkFixed, by all means use the
widget. But you should be aware of the tradeoffs.
Owen Taylor's avatar
Owen Taylor committed
60 61 62 63 64 65 66
</para>

<!-- ##### SECTION See_Also ##### -->
<para>

</para>

Matthias Clasen's avatar
2.7.0  
Matthias Clasen committed
67 68 69
<!-- ##### SECTION Stability_Level ##### -->


Owen Taylor's avatar
Owen Taylor committed
70 71 72 73 74 75
<!-- ##### STRUCT GtkFixed ##### -->
<para>
The #GtkFixed-struct struct contains the following fields.
(These fields should be considered read-only. They should never be set by
an application.)

Matthias Clasen's avatar
Matthias Clasen committed
76 77
<informaltable pgwide="1" frame="none" role="struct">
<tgroup cols="2"><colspec colwidth="2*"/><colspec colwidth="8*"/>
Owen Taylor's avatar
Owen Taylor committed
78 79 80 81 82 83 84 85 86 87 88 89
<tbody>

<row>
<entry>#GList *children;</entry>
<entry>a list of #GtkFixedChild elements, containing the child widgets and
their positions.</entry>
</row>

</tbody></tgroup></informaltable>
</para>


Soeren Sandmann's avatar
Soeren Sandmann committed
90 91 92 93 94 95 96 97 98 99
<!-- ##### ARG GtkFixed:x ##### -->
<para>

</para>

<!-- ##### ARG GtkFixed:y ##### -->
<para>

</para>

Owen Taylor's avatar
Owen Taylor committed
100 101 102 103 104 105 106 107 108 109 110 111 112 113 114 115 116 117 118 119 120 121 122 123 124 125 126 127 128 129
<!-- ##### FUNCTION gtk_fixed_new ##### -->
<para>
Creates a new #GtkFixed.
</para>

@Returns: a new #GtkFixed.


<!-- ##### FUNCTION gtk_fixed_put ##### -->
<para>
Adds a widget to a #GtkFixed container at the given position.
</para>

@fixed: a #GtkFixed.
@widget: the widget to add.
@x: the horizontal position to place the widget at.
@y: the vertical position to place the widget at.


<!-- ##### FUNCTION gtk_fixed_move ##### -->
<para>
Moves a child of a #GtkFixed container to the given position.
</para>

@fixed: a #GtkFixed.
@widget: the child widget.
@x: the horizontal position to move the widget to.
@y: the vertical position to move the widget to.


Owen Taylor's avatar
Updates  
Owen Taylor committed
130 131 132 133 134 135 136 137 138 139 140 141 142 143 144 145 146 147
<!-- ##### FUNCTION gtk_fixed_get_has_window ##### -->
<para>

</para>

@fixed: 
@Returns: 


<!-- ##### FUNCTION gtk_fixed_set_has_window ##### -->
<para>

</para>

@fixed: 
@has_window: