* Bugs 7724 13766 fixed [doc]: figure_properties/figure fixed/improved 07/20907/5
Samuel GOUGEON [Sun, 24 Mar 2019 19:08:23 +0000 (20:08 +0100)]
  http://bugzilla.scilab.org/7724  : Minimal figure sizes
  http://bugzilla.scilab.org/13766 : At creation, .auto_resize="on"
                              makes .axes_size driving .figure_size

  + .figure_size & .axes_size warning when the figure is docked

Change-Id: Ia9a05df81de0431336c37952b44a9f59b6dd9e43

scilab/CHANGES.md
scilab/modules/graphics/help/en_US/figure_operations/figure_properties.xml
scilab/modules/graphics/help/ja_JP/figure_operations/figure_properties.xml
scilab/modules/graphics/tests/nonreg_tests/bug_13766.tst [moved from scilab/modules/gui/tests/nonreg_tests/bug_13766.tst with 64% similarity]
scilab/modules/gui/help/en_US/figure.xml
scilab/modules/gui/help/ja_JP/figure.xml

index 749f5e4..59d5d24 100644 (file)
@@ -153,10 +153,12 @@ Bug Fixes
 
 ### Bugs fixed in 6.1.0:
 * [#2694](http://bugzilla.scilab.org/show_bug.cgi?id=2694): `bitget` did not accept positive integers of types int8, int16 or int32.
+* [#7724](http://bugzilla.scilab.org/show_bug.cgi?id=7724): When a figure is created in .auto_resize="on" mode, its .axes_size sets its .figure_size accordingly, not the reverse. But this was not documented.
 * [#8784](http://bugzilla.scilab.org/show_bug.cgi?id=8784): Automatic self-adjusting blocks `SCALE_CSCOPE` & `SCALE_CMSCOPE` in Xcos.
 * [#5512](http://bugzilla.scilab.org/show_bug.cgi?id=5512): `disp()` puzzlingly displayed arguments in reverse order.
 * [#9673](http://bugzilla.scilab.org/show_bug.cgi?id=9673): Priority of colon `:` operator was too low
 * [#10353](http://bugzilla.scilab.org/show_bug.cgi?id=10353): The referential for the uicontrol.position property was not provided.
+* [#13766](http://bugzilla.scilab.org/show_bug.cgi?id=13766): Minimal values for `.figure_size` were not documented.
 * [#14498](http://bugzilla.scilab.org/show_bug.cgi?id=14498): `size([],3)` returned 1 instead of 0.
 * [#14557](http://bugzilla.scilab.org/show_bug.cgi?id=14557): `csim` failed when the system has no state.
 * [#14604](http://bugzilla.scilab.org/show_bug.cgi?id=14604): `emptystr()` is 40x slower with 6.0.0 wrt 5.5.2
index 694aa93..b44b8b1 100644 (file)
@@ -2,8 +2,8 @@
 <!--
  * Scilab ( http://www.scilab.org/ ) - This file is part of Scilab
  * Copyright (C) INRIA - Djalel Abdemouche
- *
  * Copyright (C) 2012 - 2016 - Scilab Enterprises
+ * Copyright (C) 2019 - Samuel GOUGEON
  *
  * This file is hereby licensed under the terms of the GNU GPL v2.0,
  * pursuant to article 5.3.4 of the CeCILL v.2.1.
                         <varlistentry>
                             <term>figure_size: </term>
                             <listitem>
-                                <para>This property controls the size in pixel of the screen's
-                                    graphics window. The size is the vector
-                                    <literal>[width,height]</literal>.
+                                <para>
+                                    Vector <literal>[width, height]</literal>, providing the
+                                    external size of the graphic window, in screen pixels.
+                                </para>
+                                <para>
+                                <warning>
+                                    When the figure is docked (to the Scilab desktop, etc),
+                                    .figure_size holds for the whole docked block and should not
+                                    be set.
+                                </warning>
+                                <warning>
+                                    The OS window manager defines some minimal sizes. If sizes
+                                    smaller than minimal ones are provided, the minimal ones are
+                                    actually set.
+                                    <para>
+                                        On Windows, minimal sizes can be retrieved with
+                                        <screen><![CDATA[
+--> [getsystemmetrics("SM_CXMIN") getsystemmetrics("SM_CYMIN")]
+ ans  =
+   158.   45.
+]]></screen>
+                                    </para>
+                                </warning>
+                                <warning>
+                                    When a figure is created in .auto_resize="on" mode,
+                                    the .axes_size value is set as specified, and .figure_size
+                                    is set accordingly, not the reverse.
+                                </warning>
                                 </para>
                             </listitem>
                         </varlistentry>
                         <varlistentry>
                             <term>axes_size: </term>
                             <listitem>
-                                <para>Used to Specifies the size in pixel of the virtual graphics
-                                    window. The size is the vector <literal>[width,height] </literal>. The
-                                    virtual graphic window should be bigger than the part really
-                                    visible on the screen. This property could not be modified if the figure is docked
-                                    with other elements.
+                                <para>
+                                    Vector <literal>[width, height]</literal> of sizes of the whole
+                                    graphical area in the window, in pixels.
+                                </para>
+                                <warning>
+                                    This property should not be modified if the figure is docked
+                                    to the Scilab desktop.
+                                </warning>
+                            </listitem>
+                        </varlistentry>
+                        <varlistentry>
+                            <term>position: </term>
+                            <listitem>
+                                <para>
+                                    <literal>.position = [x, y, graphics_width, graphics_height]</literal>
+                                    or <literal>.position = 'x|y|graphics_width|graphics_height'</literal>
+                                    (like '100|150|500|300')
+                                    is a pseudo-property allowing to set or querry both
+                                    <literal>.figure_position</literal> and <literal>.axes_size</literal>
+                                    properties in a once.
                                 </para>
                             </listitem>
                         </varlistentry>
                         <varlistentry>
                             <term>auto_resize: </term>
                             <listitem>
-                                <para>This property determines if graphics window is resized. If the
-                                    value is <literal>"on"</literal> then the <literal>axes_size</literal>
-                                    property is equaled to the <literal>figure_size</literal> and the axes
-                                    children are zoomed accordingly. If the value is
-                                    <literal>"off"</literal> that indicate that <literal>axes_size</literal>
-                                    cannot be resized when <literal>figure_size</literal> is changed.
+                                <para>
+                                    Auto-resizing of children axes when the figure is resized.
+                                </para>
+                                <para>
+                                    When the figure is resized by hand or by setting the
+                                    .figure_size property, and .auto_resize is
+                                    <table>
+                                        <tr>
+                                            <th>"on"</th>
+                                            <td>Then the .axes_size is updated and axes contents
+                                                are zoomed accordingly, without displaying scroll
+                                                bars.
+                                            </td>
+                                        </tr>
+                                        <tr>
+                                            <th>"off"</th>
+                                            <td>Then the .axes_size is kept unchanged. The display
+                                                scale of children axes is unchanged. If the window
+                                                gets smaller than axes sizes, some scroll bars are
+                                                displayed.
+                                            </td>
+                                        </tr>
+                                    </table>
                                 </para>
                             </listitem>
                         </varlistentry>
                         <varlistentry>
                             <term>viewport: </term>
                             <listitem>
-                                <para>Position of the visible part of graphics in the
-                                    panner.
+                                <para>
+                                    Position of the visible part of graphics in the panner.
                                 </para>
                             </listitem>
                         </varlistentry>
                                 </para>
                             </listitem>
                         </varlistentry>
+                       <varlistentry>
+                            <term>BackgroundColor</term>
+                            <listitem>
+                                <para>
+                                    This pseudo-property is a set-only one. It is the same as
+                                    <literal>background</literal>, but allows to specify the color
+                                    as a [r g b] vector of real values of Red Green and Blue
+                                    intensities in [0,1] like <literal>[0.1, 0.5, 0.3]</literal>,
+                                    or as a unique equivalent 'r|g|b' string like
+                                    <literal>'0.1|0.5|0.3'</literal>, using "|" as a separator.
+                                </para>
+                            </listitem>
+                        </varlistentry>
                         <varlistentry>
                             <term>event_handler</term>
                             <listitem>
                         <varlistentry>
                             <term>info_message: </term>
                             <listitem>
-                                <para>This character string set the text displayed in the info bar of the
-                                    graphic window.
+                                <para>
+                                    Single character string: text displayed in the info bar
+                                    of the graphic window.
                                 </para>
+                                <note>
+                                    A multi-line message is possible, using ascii(10) as lines
+                                    separator, as with "Line #1"+ascii(10)+"Line #2".
+                                    Styling the text is not possible (HTML styles not supported).
+                                </note>
                             </listitem>
                         </varlistentry>
                         <varlistentry>
@@ -485,9 +561,6 @@ plot3d(t,t,sin(t)'*cos(t),35,45,'X@Y@Z',[15,2,4]);
                 <link linkend="colormap">colormap</link>
             </member>
             <member>
-                <link linkend="xname">xname</link>
-            </member>
-            <member>
                 <link linkend="scf">scf</link>
             </member>
             <member>
@@ -497,16 +570,16 @@ plot3d(t,t,sin(t)'*cos(t),35,45,'X@Y@Z',[15,2,4]);
                 <link linkend="gdf">gdf</link>
             </member>
             <member>
-                <link linkend="findobj">findobj</link>
+                <link linkend="get">get</link>
             </member>
             <member>
-                <link linkend="axes_properties">axes_properties</link>
+                <link linkend="set">set</link>
             </member>
             <member>
-                <link linkend="set">set</link>
+                <link linkend="axes_properties">axes_properties</link>
             </member>
             <member>
-                <link linkend="get">get</link>
+                <link linkend="getsystemmetrics">getsystemmetrics</link>
             </member>
         </simplelist>
     </refsection>
@@ -514,6 +587,10 @@ plot3d(t,t,sin(t)'*cos(t),35,45,'X@Y@Z',[15,2,4]);
         <title>History</title>
         <revhistory>
             <revision>
+                <revnumber>5.4.0</revnumber>
+                <revremark>New resizefcn &amp; closerequestfcn properties introduced.</revremark>
+            </revision>
+            <revision>
                 <revnumber>5.5.0</revnumber>
                 <revremark>
                     <itemizedlist>
@@ -532,10 +609,6 @@ plot3d(t,t,sin(t)'*cos(t),35,45,'X@Y@Z',[15,2,4]);
                     </itemizedlist>
                 </revremark>
             </revision>
-            <revision>
-                <revnumber>5.4.0</revnumber>
-                <revremark>New resizefcn &amp; closerequestfcn properties introduced.</revremark>
-            </revision>
         </revhistory>
     </refsection>
 </refentry>
index 7cb53ef..9214e01 100644 (file)
@@ -2,8 +2,8 @@
 <!--
  * Scilab ( http://www.scilab.org/ ) - This file is part of Scilab
  * Copyright (C) INRIA - Djalel Abdemouche
- *
  * Copyright (C) 2012 - 2016 - Scilab Enterprises
+ * Copyright (C) 2019 - Samuel GOUGEON
  *
  * This file is hereby licensed under the terms of the GNU GPL v2.0,
  * pursuant to article 5.3.4 of the CeCILL v.2.1.
                             <term>figure_size: </term>
                             <listitem>
                                 <para>
-                                    このプロパティは画面のグラフィックウインドウのピクセル単位の
-                                    大きさを制御します.この大きさはベクトル<literal>[width,height]</literal>
-                                    です.
+                                    Vector <literal>[width, height]</literal>, providing the
+                                    external size of the graphic window, in screen pixels.
+                                </para>
+                                <para>
+                                <warning>
+                                    When the figure is docked (to the Scilab desktop, etc),
+                                    .figure_size holds for the whole docked block and should not
+                                    be set.
+                                </warning>
+                                <warning>
+                                    The OS window manager defines some minimal sizes. If sizes
+                                    smaller than minimal ones are provided, the minimal ones are
+                                    actually set.
+                                    <para>
+                                        On Windows, minimal sizes can be retrieved with
+                                        <screen><![CDATA[
+--> [getsystemmetrics("SM_CXMIN") getsystemmetrics("SM_CYMIN")]
+ ans  =
+   158.   45.
+]]></screen>
+                                    </para>
+                                </warning>
+                                <warning>
+                                    When a figure is created in .auto_resize="on" mode,
+                                    the .axes_size value is set as specified, and .figure_size
+                                    is set accordingly, not the reverse.
+                                </warning>
                                 </para>
                             </listitem>
                         </varlistentry>
                             <term>axes_size: </term>
                             <listitem>
                                 <para>
-                                    仮想グラフィックウインドウにおけるピクセル単位の大きさを
-                                    指定する際に使用されます.
-                                    この大きさはベクトル <literal>[width,height] </literal> です.
-                                    仮想グラフィックウインドウは画面で実際に可視となる領域よりも
-                                    大きくなります.
-                                    このプロパティは図が他の要素に結合されている場合には修正することができません.
+                                    Vector <literal>[width, height]</literal> of sizes of the whole
+                                    graphical area in the window, in pixels.
+                                </para>
+                                <warning>
+                                    This property should not be modified if the figure is docked
+                                    to the Scilab desktop.
+                                </warning>
+                            </listitem>
+                        </varlistentry>
+                        <varlistentry>
+                            <term>position: </term>
+                            <listitem>
+                                <para>
+                                    <literal>.position = [x, y, graphics_width, graphics_height]</literal>
+                                    or <literal>.position = 'x|y|graphics_width|graphics_height'</literal>
+                                    (like '100|150|500|300')
+                                    is a pseudo-property allowing to set or querry both
+                                    <literal>.figure_position</literal> and <literal>.axes_size</literal>
+                                    properties in a once.
                                 </para>
                             </listitem>
                         </varlistentry>
                             <term>auto_resize: </term>
                             <listitem>
                                 <para>
-                                    このプロパティはグラフィックウインドウの大きさの変更動作
-                                    を定義します.
-                                    この値が <literal>"on"</literal>の場合,<literal>axes_size</literal>
-                                    プロパティは <literal>figure_size</literal>に等しくなり,
-                                    子である軸自動的に拡大・縮小されます.
-                                    この値が<literal>"off"</literal> の場合,
-                                    <literal>figure_size</literal>が変更された場合でも
-                                    <literal>axes_size</literal>は変更されません.
+                                    Auto-resizing of children axes when the figure is resized.
+                                </para>
+                                <para>
+                                    When the figure is resized by hand or by setting the
+                                    .figure_size property, and .auto_resize is
+                                    <table>
+                                        <tr>
+                                            <th>"on"</th>
+                                            <td>Then the .axes_size is updated and axes contents
+                                                are zoomed accordingly, without displaying scroll
+                                                bars.
+                                            </td>
+                                        </tr>
+                                        <tr>
+                                            <th>"off"</th>
+                                            <td>Then the .axes_size is kept unchanged. The display
+                                                scale of children axes is unchanged. If the window
+                                                gets smaller than axes sizes, some scroll bars are
+                                                displayed.
+                                            </td>
+                                        </tr>
+                                    </table>
                                 </para>
                             </listitem>
                         </varlistentry>
                                 </para>
                             </listitem>
                         </varlistentry>
+                       <varlistentry>
+                            <term>BackgroundColor</term>
+                            <listitem>
+                                <para>
+                                    This pseudo-property is a set-only one. It is the same as
+                                    <literal>background</literal>, but allows to specify the color
+                                    as a [r g b] vector of real values of Red Green and Blue
+                                    intensities in [0,1] like <literal>[0.1, 0.5, 0.3]</literal>,
+                                    or as a unique equivalent 'r|g|b' string like
+                                    <literal>'0.1|0.5|0.3'</literal>, using "|" as a separator.
+                                </para>
+                            </listitem>
+                        </varlistentry>
                         <varlistentry>
                             <term>event_handler</term>
                             <listitem>
                             <term>info_message: </term>
                             <listitem>
                                 <para>この文字列はグラフィックウインドウの情報バーに表示されるテキストを指定します.</para>
+                                <note>
+                                    A multi-line message is possible, using ascii(10) as lines
+                                    separator, as with "Line #1"+ascii(10)+"Line #2".
+                                    Styling the text is not possible (HTML styles not supported).
+                                </note>
                             </listitem>
                         </varlistentry>
                         <varlistentry>
@@ -548,9 +617,6 @@ plot3d(t,t,sin(t)'*cos(t),35,45,'X@Y@Z',[15,2,4]);
                 <link linkend="colormap">colormap</link>
             </member>
             <member>
-                <link linkend="xname">xname</link>
-            </member>
-            <member>
                 <link linkend="scf">scf</link>
             </member>
             <member>
@@ -560,16 +626,16 @@ plot3d(t,t,sin(t)'*cos(t),35,45,'X@Y@Z',[15,2,4]);
                 <link linkend="gdf">gdf</link>
             </member>
             <member>
-                <link linkend="findobj">findobj</link>
+                <link linkend="get">get</link>
             </member>
             <member>
-                <link linkend="axes_properties">axes_properties</link>
+                <link linkend="set">set</link>
             </member>
             <member>
-                <link linkend="set">set</link>
+                <link linkend="axes_properties">axes_properties</link>
             </member>
             <member>
-                <link linkend="get">get</link>
+                <link linkend="getsystemmetrics">getsystemmetrics</link>
             </member>
         </simplelist>
     </refsection>
@@ -577,6 +643,10 @@ plot3d(t,t,sin(t)'*cos(t),35,45,'X@Y@Z',[15,2,4]);
         <title>履歴</title>
         <revhistory>
             <revision>
+                <revnumber>5.4.0</revnumber>
+                <revremark>resizefcn &amp; closerequestfcn プロパティが追加されました.</revremark>
+            </revision>
+            <revision>
                 <revnumber>5.5.0</revnumber>
                 <revremark>
                     <itemizedlist>
@@ -595,10 +665,6 @@ plot3d(t,t,sin(t)'*cos(t),35,45,'X@Y@Z',[15,2,4]);
                     </itemizedlist>
                 </revremark>
             </revision>
-            <revision>
-                <revnumber>5.4.0</revnumber>
-                <revremark>resizefcn &amp; closerequestfcn プロパティが追加されました.</revremark>
-            </revision>
         </revhistory>
     </refsection>
 </refentry>
@@ -1,6 +1,7 @@
 // =============================================================================
 // Scilab ( http://www.scilab.org/ ) - This file is part of Scilab
 // Copyright (C) 2015 - Scilab Enterprises - Vincent COUVERT
+// Copyright (C) 2019 - Samuel GOUGEON
 //
 //  This file is distributed under the same license as the Scilab package.
 // =============================================================================
 fg = figure();
 fg.figure_size = [200,200];
 assert_checkequal(fg.figure_size, [200,200]);
+
+if getos()=="Windows" then
+    wmin = getsystemmetrics("SM_CXMIN")
+    hmin = getsystemmetrics("SM_CYMIN")
+    fg.figure_size = [wmin, hmin];
+    assert_checkequal(fg.figure_size, [wmin,hmin]);
+    fg.figure_size(1) = wmin - 1;
+    assert_checkequal(fg.figure_size(1), wmin);
+    fg.figure_size(1) = hmin - 1;
+    assert_checkequal(fg.figure_size(2), hmin);
+end
index c959b38..3e8761f 100644 (file)
@@ -1,5 +1,8 @@
 <?xml version="1.0" encoding="UTF-8"?>
-<refentry xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink" xmlns:svg="http://www.w3.org/2000/svg" xmlns:mml="http://www.w3.org/1998/Math/MathML" xmlns:db="http://docbook.org/ns/docbook" xmlns:scilab="http://www.scilab.org" xml:lang="en" xml:id="figure">
+<refentry xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink"
+          xmlns:svg="http://www.w3.org/2000/svg" xmlns:mml="http://www.w3.org/1998/Math/MathML"
+          xmlns:db="http://docbook.org/ns/docbook" xmlns:scilab="http://www.scilab.org"
+          xml:lang="en" xml:id="figure">
     <refnamediv>
         <refname>figure</refname>
         <refpurpose>create a figure</refpurpose>
@@ -18,7 +21,7 @@
             Otherwise, the window is created with the first free ID, that is the lowest integer not already used by a window.
         </para>
     </refsection>
-    <refsection>
+    <refsection role="arguments">
         <title>Arguments</title>
         <variablelist>
             <varlistentry>
             <varlistentry>
                 <term>PropertyName{1, ..., N}</term>
                 <listitem>
-                    <para>character string name of a property to set. One of the property names listed below.</para>
+                    <para>
+                        character string: Name of a property to set,
+                        among <link linkend="figure_properties">all existing ones</link>.
+                    </para>
+                    <warning>
+                        <itemizedlist>
+                            <listitem>
+                                <literal>'dockable'</literal>, <literal>'toolbar'</literal> and
+                                <literal>'menubar'</literal> properties can be set only at figure's
+                                creation.
+                            </listitem>
+                            <listitem>
+                                <literal>'resizefcn'</literal>: when it is set at figure's creation,
+                                the callback is first executed while building the initial figure.
+                                Hence it must already be defined and callable.
+                            </listitem>
+                        </itemizedlist>
+                    </warning>
                 </listitem>
             </varlistentry>
             <varlistentry>
         </variablelist>
     </refsection>
     <refsection>
-        <title>Properties</title>
-        <variablelist>
-            <varlistentry>
-                <term>BackgroundColor</term>
-                <listitem>
-                    <para>[1,3] real vector or string Background color of the figure. A
-                        color is specified as Red, Green and Blue values. Those values are
-                        real in [0,1]. The color can be given as a real vector, ie [R,G,B] or
-                        a string where each value is separated by a "|", ie "R|G|B"
-                    </para>
-                </listitem>
-            </varlistentry>
-            <varlistentry>
-                <term>Figure_name</term>
-                <listitem>
-                    <para>character string, allows to set the title of the figure.
-                    </para>
-                </listitem>
-            </varlistentry>
-            <varlistentry>
-                <term>Position</term>
-                <listitem>
-                    <para>allows to control the geometrical aspect of the figure.
-                        It is a [1,4] real vector [x y width height] where the letters stand for the x
-                        location of the top left corner, the y location of the top left corner, the width and the height of the virtual graphics window
-                        (the part of the figure which contains uicontrols and graphics).
-                        See the <emphasis role="bold">axes_size</emphasis> property description in <link linkend="figure_properties">figure properties</link> help page.
-                        One can also set this property by giving a string where the fields are separated by a "|", ie "x|y|width|height".
-                    </para>
-                </listitem>
-            </varlistentry>
-            <varlistentry>
-                <term>Tag</term>
-                <listitem>
-                    <para>string this property is generally used to identify the figure. It
-                        allows to give it a "name". Mainly used in conjunction with findobj().
-                    </para>
-                </listitem>
-            </varlistentry>
-            <varlistentry>
-                <term>Userdata</term>
-                <listitem>
-                    <para>this can be used to associate some Scilab objects to a figure.</para>
-                </listitem>
-            </varlistentry>
-        </variablelist>
-    </refsection>
-    <refsection>
         <title>Examples</title>
         <programlisting role="example"><![CDATA[
 // Create figure having figure_id==3
@@ -124,7 +96,7 @@ close(h);
         <title>See also</title>
         <simplelist type="inline">
             <member>
-                <link linkend="close">close</link>
+                <link linkend="scf">scf</link>
             </member>
             <member>
                 <link linkend="gcf">gcf</link>
@@ -132,6 +104,12 @@ close(h);
             <member>
                 <link linkend="createWindow">createWindow</link>
             </member>
+            <member>
+                <link linkend="figure_properties">figure_properties</link>
+            </member>
+            <member>
+                <link linkend="close">close</link>
+            </member>
         </simplelist>
     </refsection>
 </refentry>
index a11e935..c6655f6 100644 (file)
@@ -1,5 +1,8 @@
 <?xml version="1.0" encoding="UTF-8"?>
-<refentry xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink" xmlns:svg="http://www.w3.org/2000/svg" xmlns:mml="http://www.w3.org/1998/Math/MathML" xmlns:db="http://docbook.org/ns/docbook" xmlns:scilab="http://www.scilab.org" xml:lang="ja" xml:id="figure">
+<refentry xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink"
+          xmlns:svg="http://www.w3.org/2000/svg" xmlns:mml="http://www.w3.org/1998/Math/MathML"
+          xmlns:db="http://docbook.org/ns/docbook" xmlns:scilab="http://www.scilab.org"
+          xml:lang="ja" xml:id="figure">
     <refnamediv>
         <refname>figure</refname>
         <refpurpose>図を作成する</refpurpose>
@@ -21,7 +24,7 @@
             最小の番号で作成されます.
         </para>
     </refsection>
-    <refsection>
+    <refsection role="arguments">
         <title>引数</title>
         <variablelist>
             <varlistentry>
                 <listitem>
                     <para>
                         設定するプロパティ名の文字列,
-                        以下に一覧を示すプロパティ名のどれか.
+                        among <link linkend="figure_properties">all existing ones</link>.
                     </para>
+                    <warning>
+                        <itemizedlist>
+                            <listitem>
+                                <literal>'dockable'</literal>, <literal>'toolbar'</literal> and
+                                <literal>'menubar'</literal> properties can be set only at figure's
+                                creation.
+                            </listitem>
+                            <listitem>
+                                <literal>'resizefcn'</literal>: when it is set at figure's creation,
+                                the callback is first executed while building the initial figure.
+                                Hence it must already be defined and callable.
+                            </listitem>
+                        </itemizedlist>
+                    </warning>
                 </listitem>
             </varlistentry>
             <varlistentry>
         </variablelist>
     </refsection>
     <refsection>
-        <title>プロパティ</title>
-        <variablelist>
-            <varlistentry>
-                <term>BackgroundColor</term>
-                <listitem>
-                    <para>
-                        図の背景色を表す実数ベクトル [1,3] または文字列.
-                        色は赤, 緑および青の値で指定します.
-                        これらの値は[0,1]の範囲の実数です.
-                        色は実数ベクトル,すなわち[R,G,B]または
-                        "|"で区切られた文字列,すなわち"R|G|B"
-                        で指定できます.
-                    </para>
-                </listitem>
-            </varlistentry>
-            <varlistentry>
-                <term>Figure_name</term>
-                <listitem>
-                    <para>文字列, 図の表題を設定できます.
-                    </para>
-                </listitem>
-            </varlistentry>
-            <varlistentry>
-                <term>ForegroundColor</term>
-                <listitem>
-                    <para>
-                        図の表面色を表す実数ベクトル [1,3] または文字列.
-                        色は赤, 緑および青の値で指定します.
-                        これらの値は[0,1]の範囲の実数です.
-                        色は実数ベクトル,すなわち[R,G,B]または
-                        "|"で区切られた文字列,すなわち"R|G|B"
-                        で指定できます.
-                    </para>
-                </listitem>
-            </varlistentry>
-            <varlistentry>
-                <term>Position</term>
-                <listitem>
-                    <para>
-                        これにより図の外観を制御できます.
-                        [1,4]の実数ベクトルで, [x y width height]
-                        各文字は左上隅の位置x,左上隅の位置y,
-                        仮想グラフィックウインドウの幅と高さ
-                        (uicontrolsおよびグラフィックを有する図の部分)
-                        を意味します.
-                        <link linkend="figure_properties">図のプロパティ</link>
-                        のヘルプページで説明された
-                        <emphasis role="bold">axes_size</emphasis>プロパティ
-                        を参照してください.
-                        "x|y|width|height"のように
-                        フィールドを"|"で区切った文字列によりこのプロパティを
-                        指定することもできます.
-                    </para>
-                </listitem>
-            </varlistentry>
-            <varlistentry>
-                <term>Tag</term>
-                <listitem>
-                    <para>
-                        文字列で,このプロパティは一般に図を特定する際に使用されます.
-                        これにより,"名前"を付けることができるようになります.
-                        主にfindobj()と組み合わせて使用されます.
-                    </para>
-                </listitem>
-            </varlistentry>
-            <varlistentry>
-                <term>Userdata</term>
-                <listitem>
-                    <para>
-                        図に何らかのScilabオブジェクトを関連付ける際に使用できます.
-                    </para>
-                </listitem>
-            </varlistentry>
-        </variablelist>
-    </refsection>
-    <refsection>
         <title>例</title>
         <programlisting role="example"><![CDATA[
 // figure_id==3の図を作成します
@@ -143,6 +84,7 @@ uicontrol(h, "style", "text", ...
              "string", "This is a figure", ...
              "position", [50 70 100 100], ...
              "fontsize",15);
+
 // figure_id==1の図を作成します
 figure();
 // 図1のテキストuicontrolを追加します
@@ -150,6 +92,7 @@ uicontrol("style", "text", ...
           "string", "Another figure", ...
           "position", [50 70 100 100], ...
           "fontsize", 15);
+
 // カレントの図(すなわち,図1)を閉じる
 close();
 // 図3を閉じる
@@ -160,11 +103,20 @@ close(h);
         <title>参照</title>
         <simplelist type="inline">
             <member>
-                <link linkend="close">close</link>
+                <link linkend="scf">scf</link>
             </member>
             <member>
                 <link linkend="gcf">gcf</link>
             </member>
+            <member>
+                <link linkend="createWindow">createWindow</link>
+            </member>
+            <member>
+                <link linkend="figure_properties">figure_properties</link>
+            </member>
+            <member>
+                <link linkend="close">close</link>
+            </member>
         </simplelist>
     </refsection>
 </refentry>