- <para>Create a "magnetic point" (or curve) in the current window. If an anchor of another window enters in the range of action of this anchor, the 2 anchors will automatically be on the same place, and the windows are "sticked". Each anchor has a priority (<link linkend="priority">priority</link> attribute), and the anchor with the highest priority is the winner, which means that when moving its window all the other anchored windows will move too. To break the effect of 2 anchored windows, you need to move the window whose anchor has the lower priority.</para>
- <sect4 id="anchorx">
- <title>x</title>
- <para>Is it really necessary to explain ?</para>
- <para>Default value: 0</para>
- </sect4>
- <sect4 id="anchory">
- <title>y</title>
- <para>...</para>
- <para>Default value: 0</para>
- </sect4>
- <sect4 id="priority">
- <title>priority</title>
- <para>Priority of anchor (see the previous description).</para>
- <para><emphasis>Required.</emphasis></para>
- </sect4>
- <sect4 id="anchorpoints">
- <title>points</title>
- <para>Points defining the <link linkend="bezier">Bezier curve</link> followed by the anchor.</para>
- <note><para>You don't need to change this parameter if all you want is a ponctual anchor.</para></note>
- <para>Default value: (0,0)</para>
- </sect4>
- <sect4 id="range">
- <title>range</title>
- <para>Range of action of the anchor, in pixels. Default is "10".</para>
- <para>Default value: 10</para>
- </sect4>
- </sect3>
-
-
-<sect3 id="commattr">
- <title>Attributes common to all the controls</title>
- <para>The following attributes are common to all the controls (Image, Button, Checkbox, Text, Slider, RadialSlider, Playlist, Video)</para>
- <sect4 id="attrid">
- <title>id</title>
- <para>Identifiant of the control. Currently unused.</para>
- <para>Default value: none</para>
- </sect4>
- <sect4 id="visible">
- <title>visible</title>
- <para>See <link linkend="boolexpr">Boolean expressions</link>.</para>
- <para>Default value: true</para>
- </sect4>
- <sect4 id="x">
- <title>x</title>
- <para>Horizontal offset of the control, relative to the parent tag (usually <link linkend="Group">Group</link> or <link linkend="Layout">Layout</link>).</para>
- <para>Default value: 0</para>
- </sect4>
- <sect4 id="y">
- <title>y</title>
- <para>Vertical offset of the control, relative to the parent tag (usually <link linkend="Group">Group</link> or <link linkend="Layout">Layout</link>).</para>
- <para>Default value: 0</para>
- </sect4>
- <sect4 id="lefttop">
- <title>lefttop</title>
- <para>Indicate to which corner of the Layout the top-left-hand corner of this control is attached, in case of resizing. Possible values are 'lefttop', 'leftbottom', 'righttop' and 'rightbottom'.</para>
- <para>Default value: lefttop</para>
- </sect4>
- <sect4 id="rightbottom">
- <title>rightbottom</title>
- <para>Indicate to which corner of the Layout the bottom-right-hand corner of this control is attached, in case of resizing.</para>
- <para>Default value: lefttop</para>
- </sect4>
- <sect4 id="help">
- <title>help</title>
- <para>Help text for the current control. The variable '$H' will be expanded to this value when the mouse hovers the current control (see <link linkend="textvars">Text variables</link>).</para>
- <para>Default value: </para>
- </sect4>
- </sect3>
+ <para>Create a "magnetic point" (or curve) in the current window. If an anchor of another window enters in the range of action of this anchor, the 2 anchors will automatically be on the same place, and the windows are "sticked". Each anchor has a priority (<link linkend="anchorpriority">priority</link> attribute), and the anchor with the highest priority is the winner, which means that when moving its window all the other anchored windows will move too. To break the effect of 2 anchored windows, you need to move the window whose anchor has the lower priority.</para>
+ <sect3 id="anchorx">
+ <title>x</title>
+ <para>Is it really necessary to explain?</para>
+ <para>Default value: 0</para>
+ </sect3>
+ <sect3 id="anchory">
+ <title>y</title>
+ <para>...</para>
+ <para>Default value: 0</para>
+ </sect3>
+ <sect3 id="anchorlefttop">
+ <title>lefttop</title>
+ <para>Indicate to which corner of the Layout the top-left-hand corner of this anchor is attached, in case of resizing. Possible values are 'lefttop', 'leftbottom', 'righttop' and 'rightbottom'. Available since VLC 0.8.6.</para>
+ <para>Note that there is no "rightbottom" attribute for the anchors (contrarily to normal controls), because an anchor is not resizable (even when the anchor is not ponctual and follows a Bezier curve).</para>
+ <para>Default value: lefttop</para>
+ </sect3>
+ <sect3 id="anchorpriority">
+ <title>priority</title>
+ <para>Priority of anchor (see the previous description).</para>
+ <para><emphasis>Required.</emphasis></para>
+ </sect3>
+ <sect3 id="anchorpoints">
+ <title>points</title>
+ <para>Points defining the <link linkend="bezier">Bezier curve</link> followed by the anchor.</para>
+ <note><para>You don't need to change this parameter if all you want is a ponctual anchor.</para></note>
+ <para>Default value: (0,0)</para>
+ </sect3>
+ <sect3 id="anchorrange">
+ <title>range</title>
+ <para>Range of action of the anchor, in pixels.</para>
+ <para>Default value: 10</para>
+ </sect3>
+</sect2>
+
+
+<sect2 id="commattr">
+ <title>Common attributes</title>
+ <para>The following attributes are common to all the controls (Image, Button, Checkbox, Text, Slider, RadialSlider, Playlist, Playtree, Video)</para>
+ <sect3 id="attrid">
+ <title>id</title>
+ <para>Identifiant of the control. Currently unused.</para>
+ <para>Default value: none</para>
+ </sect3>
+ <sect3 id="visible">
+ <title>visible</title>
+ <para>See <link linkend="boolexpr">Boolean expressions</link>.</para>
+ <para>Default value: true</para>
+ </sect3>
+ <sect3 id="x">
+ <title>x</title>
+ <para>Horizontal offset of the control, relative to the container box (see the <link linkend="layoutmodel">Layout model</link>) or to the parent <link linkend="Group">Group</link>.</para>
+ <para>Default value: 0</para>
+ </sect3>
+ <sect3 id="y">
+ <title>y</title>
+ <para>Vertical offset of the control, relative to the container box (see the <link linkend="layoutmodel">Layout model</link>) or to the parent <link linkend="Group">Group</link>.</para>
+ <para>Default value: 0</para>
+ </sect3>
+ <sect3 id="lefttop">
+ <title>lefttop</title>
+ <para>Indicate to which corner of the container box the top-left-hand corner of this control is attached, in case of resizing. Possible values are 'lefttop', 'leftbottom', 'righttop' and 'rightbottom'. See the <link linkend="layoutmodel">Layout model</link> for more details.</para>
+ <para>Default value: lefttop</para>
+ </sect3>
+ <sect3 id="rightbottom">
+ <title>rightbottom</title>
+ <para>Indicate to which corner of the container box the bottom-right-hand corner of this control is attached, in case of resizing. See the <link linkend="layoutmodel">Layout model</link> for more details.</para>
+ <para>Default value: lefttop</para>
+ </sect3>
+ <sect3 id="xkeepratio">
+ <title>xkeepratio</title>
+ <para>When set to true, the behaviour of the horizontal resizing is changed. Instead of taking into account the <link linkend="lefttop">lefttop</link> and <link linkend="rightbottom">rightbottom</link> attributes to determine how the control will be moved/resized, only its initial position inside the container box matters. For example, if initially the space to the left of the control is twice as big as the one to its right, this will stay the same during any horizontal resizing. The width of the control stays constant.</para>
+ <para>This attribute can be particularly useful to keep a control centered in the container box, without resizing it (to resize it, you would rather use the lefttop/rightbottom attributes). See the <link linkend="layoutmodel">Layout model</link> for more details. Available since VLC 0.8.6.</para>
+ <para>Default value: false</para>
+ </sect3>
+ <sect3 id="ykeepratio">
+ <title>ykeepratio</title>
+ <para>When set to true, the behaviour of the vertical resizing is changed. Instead of taking into account the <link linkend="lefttop">lefttop</link> and <link linkend="rightbottom">rightbottom</link> attributes to determine how the control will be moved/resized, only its initial position inside the <link linkend="Layout">Layout</link> matters. For example, if initially the space to the top of the control is twice as big as the one to its bottom, this will stay the same during any vertical resizing. The height of the control stays constant.</para>
+ <para>This attribute can be particularly useful to keep a control centered in the container box, without resizing it (to resize it, you would rather use the lefttop/rightbottom attributes). See the <link linkend="layoutmodel">Layout model</link> for more details. Available since VLC 0.8.6.</para>
+ <para>Default value: false</para>
+ </sect3>
+ <sect3 id="help">
+ <title>help</title>
+ <para>Help text for the current control. The variable '$H' will be expanded to this value when the mouse hovers the current control (see <link linkend="textvars">Text variables</link>).</para>
+ <para>Default value: </para>
+ </sect3>
+</sect2>