|
||||
def pack_start(child, expand=True, fill=True, padding=0) def pack_end(child, expand=True, fill=True, padding=0) def pack_start_defaults(widget) def pack_end_defaults(widget) def set_homogeneous(homogeneous) def get_homogeneous() def set_spacing(spacing) def get_spacing() def reorder_child(child, position) def query_child_packing(child) def set_child_packing(child, expand, fill, padding, pack_type)
|
|
The gtk.Box class is an
abstract base class defining a widget that encapsulates functionality for a
particular kind of container, one that organizes a variable number of
widgets into a rectangular area. gtk.Box currently has
two families of derived classes: gtk.HBox and gtk.VBox being one,
and gtk.HButtonBox and gtk.VButtonBox --
the other.
The rectangular area of a gtk.Box is organized
into either a single row or a single column of child widgets depending upon
whether the box is of type gtk.HBox or gtk.VBox,
respectively. Thus, all children of a gtk.Box are allocated
one dimension in common, which is the height of a row, or the width of a
column.
gtk.Box
uses a notion of packing. Packing refers to adding widgets with reference to
a particular position in a gtk.Container. For a
gtk.Box, there
are two reference positions: the start and the end of the box. For a gtk.VBox, the start is
defined as the top of the box and the end is defined as the bottom. For a
gtk.HBox the
start is defined as the left side and the end is defined as the right
side.
Repeated calls to pack_start()
pack widgets into a gtk.Box from start to
end. The pack_end()
method adds widgets from end to start. You may intersperse these calls and
add widgets from both ends of the same gtk.Box.
Because gtk.Box is a gtk.Container,
you may also use add() to
insert widgets into the box, and they will be packed as if with the pack_start()
method. Use remove()
to remove widgets from the gtk.Box.
The set_homogeneous()
method specifies whether or not all children of the gtk.Box are forced to
get the same amount of space.
The set_spacing()
method determines how much space will be minimally placed between all
children in the gtk.Box.
The reorder_child()
method moves a gtk.Box child to a
different place in the box.
The set_child_packing()
method resets the expand, fill, and padding attributes of any gtk.Box child. Use the
query_child_packing()
to query these properties.
def pack_start(child, expand=True, fill=True, padding=0)
| the widget to be added to the box |
| True if child is to be
given extra space allocated to box. The extra space will be divided evenly
between all children of box that use this option. |
| True if space given to
child by the expand option is
actually allocated to child, rather than just padding
it. This parameter has no effect if expand is set to
False. A child is always allocated the full height of a gtk.HBox and the full
width of a gtk.VBox. This option
affects the other dimension. |
| extra space in pixels to put between
child and its neighbors, over and above the global
amount specified by spacing in gtk.Box. If
child is a widget at one of the reference ends of
box, then padding pixels are also put between
child and the reference edge of
box. |
The pack_start() method adds
child to the box, packed with reference to the start
of box. The child is packed after any other child
packed with reference to the start of box.
def pack_end(child, expand=True, fill=True, padding=0)
| the widget to be added to the box |
| True if child is to be
given extra space allocated to box. The extra space will be divided evenly
between all children of box that use this option. |
| True if space given to
child by the expand option is
actually allocated to child, rather than just padding
it. This parameter has no effect if expand is set to
False. A child is always allocated the full height of a gtk.HBox and the full
width of a gtk.VBox. This option
affects the other dimension. |
| extra space in pixels to put between
child and its neighbors, over and above the global
amount specified by spacing in gtk.Box. If
child is a widget at one of the reference ends of
box, then padding pixels are also put between
child and the reference edge of
box. |
The pack_end() method adds
child to the box, packed with reference to the end of
the box. The child is packed after (away from end of)
any other child packed with reference to the end of the box.
def pack_start_defaults(widget)
| the widget to be added to the box |
This method is deprecated in PyGTK 2.4 and above.
The pack_start_defaults() method adds
widget to the box, packed with reference to the start
of the box. The widget is packed after any other
child widget packed with reference to the start of box. The parameters for
packing the child widget: expand, fill, and padding are given their default
values, True, True, and 0, respectively.
def pack_end_defaults(widget)
| the widget to be added to the box |
This method is deprecated in PyGTK 2.4 and above.
The pack_end_defaults() method adds
widget to the box, packed with reference to the end
of the box. The widget is packed after (away from the
end of) any other child widget packed with reference to the end of the box.
The parameters for packing the child widget: expand, fill, and padding are
given their default values, True, True, and 0, respectively.
def set_homogeneous(homogeneous)
| If True the box is
homogeneous i.e. all children are allocated the same space otherwise the
allocations vary for each child. |
The set_homogeneous() method sets the
homogeneous (all children are allocated the same space) property of the
box.
def get_homogeneous()Returns : | True if the box is
homogeneous. |
The get_homogeneous() method returns
whether the box is homogeneous (all children are allocated the same space).
See gtk.Box.set_homogeneous().
def set_spacing(spacing)
| the number of pixels to put between children. |
The set_spacing() method sets the
number of pixels to place between children of the box.
def get_spacing()Returns : | the spacing in pixels between children |
The get_spacing() method returns the
number of pixels used as padding between children as set by the set_spacing().
def reorder_child(child, position)
| the child widget to move |
| the new position for child in the children list of the box starting from 0. If negative, indicates the end of the list. |
Moves child to a new position in the list of the box children. The list contains both widgets packed gtk.PACK_START as well as widgets packed gtk.PACK_END, in the order that these widgets were added to box.
A widget's position in the box children list determines where the widget is packed into box. A child widget at some position in the list will be packed just after all other widgets of the same packing type that appear earlier in the list.
def query_child_packing(child)
| the child widget to be queried for its packing information |
| the child's expand value |
| the child's fill value |
| the child's padding value |
| the child's pack_type value |
The query_child_packing() method
returns a tuple containing information about how child
is packed into the box. The tuple members are: (expand, fill, padding,
pack_type) where: expand and fill are 0 or 1 (corresponding to False or
True); padding is the number of pixels of padding; and pack_type is
gtk.PACK_START or gtk.PACK_END.
def set_child_packing(child, expand, fill, padding, pack_type)
| the child widget to be queried for its packing information |
| the child's new expand value |
| the child's new fill value |
| the child's new padding value |
| the child's new pack_type value |
The set_child_packing() method sets the
way child is packed into the box.
© manpagez.com 2000-2024 Individual documents may contain additional copyright information.