org.gnu.gtk
Class SizeGroup
public class SizeGroup
extends GObject
SizeGroup provides a mechanism for grouping a number of widgets together so
they all request the same amount of space. This is typically useful when you
want a column of widgets to have the same size, but you can't use a
Table
widget.
In detail, the size requested for each widget in a SizeGroup is the maximum
of the sizes that would have been requested for each widget in the size group
if they were not in the size group. The mode of the size group (see
setMode(SizeGroupMode)
determines whether this applies to the
horizontal size, the vertical size, or both sizes.
Note that size groups only affect the amount of space requested, not the size
that the widgets finally receive. If you want the widgets in a SizeGroup to
actually be the same size, you need to pack them in such a way that they get
the size they request and not more. For example, if you are packing your
widgets into a table, you would not include the GTK_FILL flag.
Widgets can be part of multiple size groups; GTK+ will compute the horizontal
size of a widget from the horizontal requisition of all widgets that can be
reached from the widget by a chain of size groups of type
GTK_SIZE_GROUP_HORIZONTAL or GTK_SIZE_GROUP_BOTH, and the vertical size from
the vertical requisition of all widgets that can be reached from the widget
by a chain of size groups of type GTK_SIZE_GROUP_VERTICAL or
GTK_SIZE_GROUP_BOTH.
SizeGroup
public SizeGroup(SizeGroupMode mode)
Create a new SizeGroup
mode
- The mode for the new Size Group
addWidget
public void addWidget(Widget widget)
Adds a widget to the SizeGroup. In the future, the requisition of the
widget will be determined as the maximum of its requisition and the
requisition of the other widgets in the size group. Whether this applies
horizontally, vertically, or in both directions depends on the mode of
the size group. See
setMode(SizeGroupMode)
.
widget
- The Widget to add.
getType
public static Type getType()
Retrieve the runtime type used by the GLib library.
removeWidget
public void removeWidget(Widget widget)
Removes a widget from the group
widget
- The widget to remove
setMode
public void setMode(SizeGroupMode mode)
Sets the
SizeGroupMode
of the size group. The mode of the size
group determines whether the widgets in the size group should all have
the same horizontal requisition (SizeGroupMode.HORIZONTAL) all have the
same vertical requisition (SizeGroupMode.VERTICAL), or should all have
the same requisition in both directions (SizeGroupMode.BOTH).
mode
- The mode to set for the SizeGroup