<link linkend="layouts-box-example-1">full example</link>. It
demonstrates how to lay out three rectangles in a vertical
column. A different approach is used to set the <varname>x-fill</varname>
- property on each rectangle, so that they fill the horizontal space in
+ property on each rectangle, so each fills the horizontal space in
the layout (each rectangle is 100 pixels wide, while the
box they are inside is 200 pixels wide).</para>
<para><type>ClutterBoxLayout</type> is not a reflowing layout:
that is, if the layout's container changes size, the actors inside
- aren't automatically repositioned to fill the available area.
- If you want that behaviour, use <type>ClutterFlowLayout</type>
- instead.</para>
+ aren't automatically repositioned to occupy or find new positions
+ in its available area. If you want that behaviour, use
+ <type>ClutterFlowLayout</type> instead.</para>
- <para>If you want the container to be resizable, but still want
- access to the actors inside it if they go outside its clip area,
- you can provide another way to get to them. For example, you
- could put the container inside a scrollable area, so the
- container's actors can be scrolled to if they go out of sight.</para>
+ <para>If you want the container to be resizable, but find that
+ resizing the container obscures its child actors, you could put
+ the container inside a scrollable area. Then the container's actors
+ can be scrolled to if they go out of sight.
+ <link linkend="events-mouse-scroll">This recipe</link> explains
+ how to make a container scrollable.</para>
<section>
<title>Layout properties</title>
<para>The main issue you may face when applying these properties
is understanding how they interact. As this is harder to describe
than to show, you can run the
- <link linkend="layouts-box-example-3">third example</link>
- below to toggle and tweak the various properties.</para>
+ <link linkend="layouts-box-example-3">example</link>
+ below to toggle and tweak various properties and see
+ how they affect the layout's appearance.</para>
<note>
- <para>The second example sets child properties (fill, alignment,
- expand) on all children of the layout when those properties are
- changed. If you want to see the effect of setting these to
- different values for <emphasis>each</emphasis> child, you
- will have to experiment yourself.</para>
+ <para>The "toggle and tweak"
+ <link linkend="layouts-box-example-3">example</link> sets
+ child properties (fill, alignment, expand) on all children
+ of the layout when those properties are changed. If you want
+ to see the effect of setting these to different values for
+ <emphasis>each</emphasis> child, you will have to experiment
+ yourself.</para>
</note>
<section>
<para>Sets the number of pixels to place between actors
in the layout.</para>
- <para>Note that if you increase spacing too much, actors
- may go outside the edges of the layout's container (if
- the container has a fixed size).</para>
</formalpara>
+
+ <para>Note that if you increase spacing too much, actors
+ may go outside the edges of the layout's container (if
+ the container has a fixed size).</para>
</listitem>
<listitem>
prepend actors to the row or column; the default is
<constant>FALSE</constant>, meaning that actors are
appended to the row or column when added.</para>
-
- <para>Changing this property on a layout which already has
- actors in it will reverse the order of those actors, as
- well as changing how new actors are added to the layout.</para>
</formalpara>
+
+ <para>Changing this property on a layout which already has
+ actors in it will reverse the order of those actors, as
+ well as changing how new actors are added to the layout.</para>
</listitem>
</itemizedlist>
set whether an actor will fill its allocated horizontal
or vertical space (respectively) within the layout. Setting
these properties only has an effect where an actor is smaller
- (on the fill axis or axes) than the layout's container.</para>
+ (on the appropriate fill axes) than the layout's container.</para>
- <para>Note that the actor's size is not actually changed
+ <para>Note that the actor's actual size is not changed
if it is set to fill: the reported width and height are
- not affected.</para>
+ unaffected.</para>
</listitem>
<listitem>
introduction</link> for more about easing and duration
properties).</para>
- <para>The <link linkend="layouts-box-example-3">third example</link>
- uses animation for layout changes, and can give you some idea
- of what to expect in your own animated layouts.</para>
+ <para>The <link linkend="layouts-box-example-3">"toggle and tweak"
+ example</link> uses animation for layout changes, and can give
+ you some idea of what to expect in your own animated layouts.</para>
</section>
</section>
</example>
<example id="layouts-box-example-3">
- <title>A demonstrator for some of <type>ClutterBoxLayout's</type>
- properties</title>
+ <title>A demonstrator for "toggling and tweaking" a
+ <type>ClutterBoxLayout's</type> properties</title>
<programlisting>
<xi:include href="examples/layouts-box-property-effects.c" parse="text">
<xi:fallback>a code sample should be here... but isn't</xi:fallback>