Document recent changes on uicontrols. 63/14163/4
Vincent COUVERT [Thu, 27 Mar 2014 13:05:47 +0000 (14:05 +0100)]
Only display uicontrol properties if used in Java.

Change-Id: Ifda733d867daa2cd149cc78f07910f30a5999c15

scilab/modules/graphics/macros/%h_p.sci
scilab/modules/gui/help/en_US/uicontrol.xml
scilab/modules/gui/help/en_US/uicontrol_properties.xml

index f5959c1..1946990 100755 (executable)
@@ -968,68 +968,76 @@ function %h_p(h)
                 b = b(1);
                 b = b(1);
             end
-            if h.style == "tab" then
-                t=[t;
-                "Parent: "+h.parent.type
-                "Children: "+fmtchildren(h.children)
-                "Enable = "+sci2exp(h.enable)
-                "BackgroundColor = "+sci2exp(h.backgroundcolor,0)
-                "ForegroundColor = "+sci2exp(h.foregroundcolor,0)
-                "Relief = "+h.relief
-                "String = "+fmtuser_data(h.string)
-                "Style = "+h.style
-                "Visible = "+sci2exp(h.visible)
-                "Callback = "+h.callback
-                "Callback_Type = "+sci2exp(h.callback_type,0)
-                "Layout = "+sci2exp(h.layout)
-                "Layout_options = "+sci2exp(l)
-                "Constraints = "+sci2exp(c)
-                "Margins = "+sci2exp(h.margins)
-                "Title_position = "+sci2exp(h.title_position)
-                "Title_scroll = "+sci2exp(h.title_scroll)
-                "Userdata = "+fmtuser_data(u)
-                "Tag = "+h.tag
-                ]
-            else
-                t=[t;
-                "Parent: "+h.parent.type
-                "Children: "+fmtchildren(h.children)
-                "BackgroundColor = "+sci2exp(h.backgroundcolor,0)
-                "Enable = "+sci2exp(h.enable)
-                "FontAngle = "+h.fontangle
-                "FontName = "+h.fontname
-                "FontSize = "+sci2exp(h.fontsize)
-                "FontUnits = "+h.fontunits
-                "FontWeight = "+h.fontweight
-                "ForegroundColor = "+sci2exp(h.foregroundcolor,0)
-                "HorizontalAlignment = "+h.horizontalalignment
-                "ListboxTop = "+sci2exp(h.listboxtop,0)
-                "Max = "+sci2exp(h.max)
-                "Min = "+sci2exp(h.min)
-                "Position = "+sci2exp(h.position,0)
-                "Relief = "+h.relief
-                "SliderStep = "+sci2exp(h.sliderstep)
-                "String = "+fmtuser_data(h.string)
-                "Style = "+h.style
-                "TooltipString = "+fmtuser_data(h.tooltipstring)
-                "Units = "+h.units
-                "Value = "+sci2exp(h.value,0)
-                "VerticalAlignment = "+h.verticalalignment
-                "Visible = "+sci2exp(h.visible)
-                "Callback = "+h.callback
-                "Callback_Type = "+sci2exp(h.callback_type,0)
-                "Layout = "+sci2exp(h.layout)
-                "Layout_options = "+sci2exp(l)
-                "Constraints = "+sci2exp(c)
-                "Border = "+sci2exp(b)
-                "Margins = "+sci2exp(h.margins)
-                "Groupname = "+sci2exp(h.groupname)
-                "Scrollable = "+sci2exp(h.scrollable)
-                "Icon = "+fmtuser_data(h.icon)
-                "Userdata = "+fmtuser_data(u)
-                "Tag = "+h.tag
-                ]
+
+            showHiddenProperties = get(get(0), "ShowHiddenProperties") == "on";
+            t = [];
+            t($+1) = "Parent: "+h.parent.type;
+            t($+1) = "Children: "+fmtchildren(h.children);
+            t($+1) = "";
+            t($+1) = "Style = "+h.style;
+            t($+1) = "";
+            t($+1) = "BackgroundColor = "+sci2exp(h.backgroundcolor,0);
+            if h.style == "frame" | showHiddenProperties then
+                t($+1) = "Border = "+sci2exp(b);
+            end
+            if and(h.style <> ["frame", "layer", "text"]) | showHiddenProperties then
+                t($+1) = "Callback = "+h.callback;
+                t($+1) = "Callback_Type = "+sci2exp(h.callback_type,0);
+            end
+            t($+1) = "Constraints = "+sci2exp(c);
+            t($+1) = "Enable = "+sci2exp(h.enable);
+            if and(h.style <> ["frame", "layer"]) | showHiddenProperties then
+                t($+1) = "FontAngle = "+h.fontangle;
+                t($+1) = "FontName = "+h.fontname;
+                t($+1) = "FontSize = "+sci2exp(h.fontsize);
+                t($+1) = "FontUnits = "+h.fontunits;
+                t($+1) = "FontWeight = "+h.fontweight;
+            end
+            t($+1) = "ForegroundColor = "+sci2exp(h.foregroundcolor,0);
+            if or(h.style == ["radiobutton", "checkbox"]) | showHiddenProperties then
+                t($+1) = "Groupname = "+sci2exp(h.groupname);
+            end
+            t($+1) = "HorizontalAlignment = "+h.horizontalalignment;
+            if and(h.style <> ["frame", "layer"]) | showHiddenProperties then
+                t($+1) = "Icon = "+fmtuser_data(h.icon);
             end
+            if h.style == "frame" | showHiddenProperties then
+                t($+1) = "Layout = "+sci2exp(h.layout);
+                t($+1) = "Layout_options = "+sci2exp(l);
+            end
+            if h.style == "listbox" | showHiddenProperties then
+                t($+1) = "ListboxTop = "+sci2exp(h.listboxtop,0);
+            end
+            t($+1) = "Margins = "+sci2exp(h.margins);
+            if or(h.style == ["checkbox", "radiobutton", "slider", "spinner", "listbox", "edit"]) | showHiddenProperties then
+                t($+1) = "Max = "+sci2exp(h.max);
+                t($+1) = "Min = "+sci2exp(h.min);
+            end
+            t($+1) = "Position = "+sci2exp(h.position,0);
+            t($+1) = "Relief = "+h.relief;
+            if or(h.style == ["frame", "edit"]) | showHiddenProperties then
+                t($+1) = "Scrollable = "+sci2exp(h.scrollable);
+            end
+            if or(h.style == ["slider", "spinner"]) | showHiddenProperties then
+                t($+1) = "SliderStep = "+sci2exp(h.sliderstep);
+            end
+            if h.style == "slider" | showHiddenProperties then
+                t($+1) = "String = "+fmtuser_data(h.string);
+            end
+            t($+1) = "Tag = "+h.tag;
+            if h.style == "tab" | showHiddenProperties then
+                t($+1) = "Title_position = "+sci2exp(h.title_position);
+                t($+1) = "Title_scroll = "+sci2exp(h.title_scroll);
+            end
+            t($+1) = "TooltipString = "+fmtuser_data(h.tooltipstring);
+            t($+1) = "Units = "+h.units;
+            t($+1) = "Userdata = "+fmtuser_data(u);
+            if or(h.style == ["checkbox", "radiobutton", "slider", "spinner", "listbox", "edit", "layer", "tab"]) | showHiddenProperties then
+                t($+1) = "Value = "+sci2exp(h.value,0);
+            end
+            t($+1) = "VerticalAlignment = "+h.verticalalignment;
+            t($+1) = "Visible = "+sci2exp(h.visible);
+
             // Console
             // =====================================================================
 
index 483b928..f65378b 100644 (file)
         </para>
         <itemizedlist>
             <listitem>
-                <para>Pushbutton: (default style)a rectangular button generally used to run a callback.
+                <para>Checkbox: a button with two states (Used for multiple independent choices).
                 </para>
             </listitem>
             <listitem>
-                <para>Radiobutton: a button with two states. RadioButtons are
-                    intended to be mutually exclusive (Your code must implement
-                    mutually exclusive behavior).
+                <para>Edit: an editable string zone.</para>
+            </listitem>
+            <listitem>
+                <para>Frame: a container for other uicontrols.
                 </para>
             </listitem>
             <listitem>
-                <para>Checkbox: a button with two states (Used for multiple
-                    independent choices).
+                <para>Image: a component where a specified image is displayed.</para>
+            </listitem>
+            <listitem>
+                <para>
+                    Layer: a container for <literal>frame</literal> style uicontrols enbaling to switch between them programmatically using the <literal>value</literal> property.
                 </para>
             </listitem>
             <listitem>
-                <para>Edit: an editable string zone.</para>
+                <para>Listbox: a control representing a list of items that can be scrolled. The items can be selected with the mouse.</para>
             </listitem>
             <listitem>
-                <para>Text: a text control (generally static).</para>
+                <para>Popupmenu: a button which make a menu appear when clicked.</para>
             </listitem>
             <listitem>
-                <para>Slider: a scale control, that is a scrollbar use to set
-                    values between in range with the mouse.
+                <para>Pushbutton: (default style) a rectangular button generally used to run a callback.
                 </para>
             </listitem>
             <listitem>
-                <para>Frame: a control representing a zone used to group related
-                    controls.
+                <para>Radiobutton: a button with two states. RadioButtons are intended to be mutually exclusive.</para>
+                <para>
+                    Your code must implement mutually exclusive behavior if you do not use groups 
+                    (See <literal>GroupName</literal> property in <link linkend="uicontrol_properties">uicontrol properties</link>).
                 </para>
             </listitem>
             <listitem>
-                <para>Listbox: a control representing a list of items that can
-                    be scrolled. The items can be selected with the mouse.
-                </para>
+                <para>Slider: a scale control, that is a slider used to set values between in range with the mouse.</para>
             </listitem>
             <listitem>
-                <para>Popupmenu: a button which make a menu appear when
-                    clicked.
-                </para>
+                <para>Spinner: a component which enables the user to select/edit a value between bounds with a fixed step.</para>
             </listitem>
             <listitem>
-                <para>Image: a sub-window where the image specified is displayed.</para>
+                <para>
+                    Tab: a container for <literal>frame</literal> style uicontrols enabling to switch between them by cliking on a tab with a given title and/or icon.
+                </para>
+                <para>The font related properties set on the frame will be used for the tab label.</para>
             </listitem>
             <listitem>
                 <para>Table: an editable table.</para>
             </listitem>
+            <listitem>
+                <para>Text: a text control (generally static).</para>
+            </listitem>
         </itemizedlist>
     </refsection>
     <refsection>
@@ -198,4 +205,28 @@ matrix(ut.string,size(table))
             </member>
         </simplelist>
     </refsection>
+    <refsection>
+        <title>History</title>
+        <revhistory>
+            <revision>
+                <revnumber>5.5.0</revnumber>
+                <revremark>
+                    <para>
+                        New styles added:
+                    </para>
+                    <itemizedlist>
+                        <listitem>Tab</listitem>
+                        <listitem>Spinner</listitem>
+                        <listitem>Layer</listitem>
+                    </itemizedlist>
+                    <para>
+                        Uicontrols rendering is now based on operating system look and feel (See <link linkend="console_properties">console properties</link>).
+                    </para>
+                    <para>
+                        Uicontrols handles display is now limited to properties used by Java rendering (See <link linkend="console_properties">console properties</link>).
+                    </para>
+                </revremark>
+            </revision>
+        </revhistory>
+    </refsection>
 </refentry>
index f2223cb..5d0789f 100644 (file)
                         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>
+                    <para>
+                        Setting this property to <literal>[-1 -1 -1]</literal> will let the look and feel set the default background color.
+                    </para>
+                </listitem>
+            </varlistentry>
+            <varlistentry>
+                <term>Border</term>
+                <listitem>
+                    <para>A Border object.</para>
+                    <para>
+                        Only used for <literal>frame</literal> style uicontrols, this object is created using <link linkend="createBorder">createBorder</link>.
+                    </para>
+                    <para>
+                        Setting this value to <literal>[]</literal> removes the border of the frame.
+                    </para>
                 </listitem>
             </varlistentry>
             <varlistentry>
                 <term>Callback</term>
                 <listitem>
                     <para>String</para>
-                    <para>Instruction evaluated by the Scilab interpreter when an
-                        uicontrol is activated. (for example when you click on a
-                        button).
+                    <para>Instruction evaluated by the Scilab interpreter when an uicontrol is activated (for example when you click on a button).</para>
+                    <para>
+                        This property is not used for <literal>layer</literal>, <literal>frame</literal> and <literal>text</literal> style uicontrols.
                     </para>
                 </listitem>
             </varlistentry>
                 </listitem>
             </varlistentry>
             <varlistentry>
+                <term>Constraints</term>
+                <listitem>
+                    <para>A Constraints object.</para>
+                    <para>
+                        This object is created using <link linkend="createConstraints">createConstraints</link>
+                        and describes the constraints on the position and size of the uicontrol regarding to its parent.
+                    </para>
+                    <para>
+                        Setting this value to <literal>[]</literal> clears the constraints.
+                    </para>
+                </listitem>
+            </varlistentry>
+            <varlistentry>
                 <term>Enable</term>
                 <listitem>
                     <para>{on} | off</para>
                 <term>FontAngle</term>
                 <listitem>
                     <para>{normal} | italic | oblique</para>
-                    <para>For a control containing some text, this property sets the
-                        slant of the font.
-                    </para>
+                    <para>For a control containing some text, this property sets the slant of the font.</para>
                 </listitem>
             </varlistentry>
             <varlistentry>
                 <term>FontSize</term>
                 <listitem>
                     <para>Scalar</para>
-                    <para>For a control containing some text, this property sets the
-                        size of the font in FontUnits.
+                    <para>For a control containing some text, this property sets the size of the font in FontUnits.
                     </para>
                 </listitem>
             </varlistentry>
                         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>
+                    <para>
+                        Setting this property to <literal>[-1 -1 -1]</literal> will let the look and feel set the default foreground color.
+                    </para>
+                </listitem>
+            </varlistentry>
+            <varlistentry>
+                <term>Groupname</term>
+                <listitem>
+                    <para>String</para>
+                    <para>
+                        Used for <literal>radiobutton</literal> and <literal>checkbox</literal> style uicontrols, 
+                        this property allow to manage uicontrols of the same group as a whole. For example, <literal>checkbox</literal> uicontrols of a group
+                        will manage selection unicity automatically.
+                    </para>
                 </listitem>
             </varlistentry>
             <varlistentry>
                 <term>HorizontalAlignment</term>
                 <listitem>
                     <para>left | {center} | right</para>
-                    <para>Set text horizontal alignment in the uicontrol. This property
-                        has only effect with Text, Edit and Check Boxes.
+                    <para>Set text horizontal alignment in the uicontrol.</para>
+                </listitem>
+            </varlistentry>
+            <varlistentry>
+                <term>Icon</term>
+                <listitem>
+                    <para>String.</para>
+                    <para>
+                        This property represents the relative (to <link linkend="pwd">Scilab working directory</link>) or absolute path of the image file to be
+                        used as icon for a <literal>pushbutton</literal> or <literal>text</literal> uicontrol.
+                    </para>
+                    <para>
+                        For <literal>frame</literal> uicontrols in <literal>tab</literal> uicontrols, the icon property sets the icon of its sheet.
+                    </para>
+                </listitem>
+            </varlistentry>
+            <varlistentry>
+                <term>Layout: </term>
+                <listitem>
+                    <para>
+                        This property sets the layout used to dispose <literal>frame</literal> uicontrols children.
+                        See <link linkend="layout">layout</link> page for more information about available layouts.
+                    </para>
+                </listitem>
+            </varlistentry>
+            <varlistentry>
+                <term>Layout_options: </term>
+                <listitem>
+                    <para>
+                        This property sets the options of the layout used to dispose <literal>frame</literal> children. See <link linkend="layout">layout</link> page for more information about available options.
                     </para>
                 </listitem>
             </varlistentry>
                 <term>ListboxTop</term>
                 <listitem>
                     <para>Scalar</para>
-                    <para>For a ListBox, this property tells which item of the list
-                        appears on the first line of the visible area of the list.
+                    <para>
+                        Only used for <literal>listbox</literal> uicontrols, this property tells which item of the list appears on the first line of the visible area of the list.
+                    </para>
+                </listitem>
+            </varlistentry>
+            <varlistentry>
+                <term>Margins</term>
+                <listitem>
+                    <para>[1,4] real vector.</para>
+                    <para>
+                        Sets an empty space around the uicontrol under the form <literal>[top, left, bottom, right]</literal> (in pixels).
                     </para>
                 </listitem>
             </varlistentry>
                     </para>
                     <itemizedlist>
                         <listitem>
-                            <para>CheckBoxes: Max is the value the "Value" property take
-                                when control is checked.
+                            <para>
+                                <literal>checkbox</literal> and <literal>radiobutton</literal> uicontrols: Max is the value the "Value" property take when control is checked.
                             </para>
                         </listitem>
                         <listitem>
-                            <para>Sliders: Maximum value of the slider.</para>
+                            <para>
+                                <literal>slider</literal> and <literal>spinner</literal> uicontrols: Maximum value of the component.
+                            </para>
+                        </listitem>
+                        <listitem>
+                            <para>
+                                <literal>listbox</literal> uicontrols: if (Max-Min)&gt;1 the list allows multiple selection.
+                            </para>
                         </listitem>
                         <listitem>
-                            <para>ListBoxes: if (Max-Min)&gt;1 the list allows multiple
-                                selection, Otherwise not.
+                            <para>
+                                <literal>edit</literal> uicontrols: if (Max-Min)&gt;1 the edit allows multiple line edition.
                             </para>
                         </listitem>
                     </itemizedlist>
                     </para>
                     <itemizedlist>
                         <listitem>
-                            <para>CheckBoxes: Min is the value the "Value" property take
-                                when control is unchecked.
+                            <para>
+                                <literal>checkbox</literal> and <literal>radiobutton</literal> uicontrols: Min is the value the "Value" property take when control is unchecked.
                             </para>
                         </listitem>
                         <listitem>
-                            <para>Sliders: Minimum value of the slider.</para>
+                            <para>
+                                <literal>slider</literal> and <literal>spinner</literal> uicontrols: Minimum value of the component.
+                            </para>
                         </listitem>
                         <listitem>
-                            <para>ListBoxes: if (Max-Min)&gt;1 the list allows multiple
-                                selection, Otherwise not.
+                            <para>
+                                <literal>listbox</literal> uicontrols: if (Max-Min)&gt;1 the list allows multiple selection.
+                            </para>
+                        </listitem>
+                        <listitem>
+                            <para>
+                                <literal>edit</literal> uicontrols: if (Max-Min)&gt;1 the edit allows multiple line edition.
                             </para>
                         </listitem>
                     </itemizedlist>
                 </listitem>
             </varlistentry>
             <varlistentry>
-                <term>Path</term>
-                <listitem>
-                    <para>This property is no more supported.</para>
-                </listitem>
-            </varlistentry>
-            <varlistentry>
                 <term>Position</term>
                 <listitem>
                     <para>[1,4] real vector or string.</para>
                     <para>When using the deprecated skin for uicontrols, default values are related to uicontrol style:</para>
                     <itemizedlist>
                         <listitem>
-                            <para>PushButtons: the default value for "Relief" property is
-                                "raised".
+                            <para>
+                                <literal>pushbutton</literal> uicontrols: the default value for "Relief" property is "raised".
                             </para>
                         </listitem>
                         <listitem>
-                            <para>Edits: the default value for "Relief" property is
-                                "sunken".
+                            <para>
+                                <literal>edit</literal> uicontrols: the default value for "Relief" property is "sunken".
                             </para>
                         </listitem>
                         <listitem>
-                            <para>Other styles: the default value for "Relief" property is
-                                "flat".
-                            </para>
+                            <para>Other uicontrols: the default value for "Relief" property is "flat".</para>
                         </listitem>
                     </itemizedlist>
                 </listitem>
             </varlistentry>
             <varlistentry>
+                <term>Scrollable</term>
+                <listitem>
+                    <para>Boolean.</para>
+                    <para>
+                        Used for <literal>frame</literal> and <literal>edit</literal> style uicontrols, this property indicates if the uicontrol must have scrolling capabilities (<literal>%T</literal>) or not (default <literal>%F</literal>).
+                    </para>
+                    <para>
+                        For <literal>frame</literal> this value must be set at creation.
+                    </para>
+                </listitem>
+            </varlistentry>
+            <varlistentry>
                 <term>SliderStep</term>
                 <listitem>
                     <para>[1,2] real vector</para>
                         using Ctrl-keyboard-arrows. If the big step is omitted, it is
                         defaulted to 1/10 of the scale.
                     </para>
+                    <para>
+                        For <literal>spinner</literal> uicontrol, the first value of this property is used as fixed step.
+                    </para>
                 </listitem>
             </varlistentry>
             <varlistentry>
                         the value can be a vector of string or a string where the items are
                         separated by a "|". For Text uicontrols, this string can contain HTML code to format the text.
                     </para>
-                    <para>
-                        For Pushbutton or Text uicontrols, if the text is enclosed between two $ (dollar sign), then it will be
-                        considered as a LaTeX expression, and if it is enclosed between &lt; and &gt;, it will be considered
-                        as a MathML one.
-                    </para>
-                    <para>
-                        For Image, the value specifies the path of the image file.
+                    <itemizedlist>
+                        <listitem>
+                            <para>  
+                                For <literal>pushbutton</literal> or <literal>text</literal> uicontrols, if the text is enclosed between two $ (dollar sign), then it will be
+                                considered as a LaTeX expression, and if it is enclosed between &lt; and &gt;, it will be considered
+                                as a MathML one.
+                            </para>
+                        </listitem>
+                        <listitem>
+                            <para>
+                                For <literal>layer</literal> and <literal>tab</literal> uicontrols, the value specifies the tag of the selected child.
+                            </para>
+                        </listitem>
+                        <listitem>
+                            <para>
+                                For <literal>image</literal> uicontrols, the value specifies the path of the image file.
+                            </para>
+                        </listitem>
+                        <listitem>
+                            <para>
+                                For <literal>table</literal> uicontrols, the value specifies the whole table data: <literal>[IGNORED COL1-HEADER...COLN-HEADER;ROW1-HEADER, ROW1COL1-DATA, ROW1COLN-DATA;...;ROWM-HEADER, ROWMCOL1-DATA, ROWMCOLN-DATA]</literal>.
+                            </para>
+                        </listitem>
+                        <listitem>
+                            <para>
+                                For <literal>listbox</literal> and <literal>popupmenu</literal> uicontrols which manage colors selection, icons, background
+                                and foreground colors, the <literal>String</literal> property can be set to a matrix matching the format:
+                                <literal>["#color1", "Item1", "#background1", "#foreground1"; "#color2", "Item2", ..., ...]</literal> 
+                                <literal>["icon1", "Item1", "#background1", "#foreground1"; "icon2", "Item2", ..., ...]</literal> 
+                                with <literal>"#color1"</literal>, <literal>"#background1"</literal> and <literal>"#foreground1"</literal> in HTML format <literal>#XXXXXX</literal>.
+                                Then the component will display a colored box or icon on the left of the associated string,
+                                and different background/foreground colors for items.
+                            </para>
+                        </listitem>
+                    </itemizedlist>
+                    
+                </listitem>
+            </varlistentry>
+            <varlistentry>
+                <term>Tag</term>
+                <listitem>
+                    <para>String</para>
+                    <para>This property is generally used to identify the control. It
+                        allows to give it a "name". Mainly used in conjunction with
+                        <literal>findobj()</literal>.
                     </para>
+                </listitem>
+            </varlistentry>
+            <varlistentry>
+                <term>Title_position</term>
+                <listitem>
+                    <para>{top} | left | bottom | right</para>
                     <para>
-                        For Table, the value specifies the whole table data: <literal>[IGNORED COL1-HEADER...COLN-HEADER;ROW1-HEADER, ROW1COL1-DATA, ROW1COLN-DATA;...;ROWM-HEADER, ROWMCOL1-DATA, ROWMCOLN-DATA]</literal>.
+                        The position of the tabs of a <literal>tab</literal> style uicontrol.
                     </para>
                 </listitem>
             </varlistentry>
             <varlistentry>
-                <term>TooltipString</term>
+                <term>Title_scroll</term>
                 <listitem>
-                    <para>String or String vector</para>
+                    <para>Boolean</para>
                     <para>
-                        This property represents the text of the uicontrol tooltip appearing when the mouse is over the uicontrol.
+                        Indicates whether the tabs of a <literal>tab</literal> style uicontrol 
+                        must be wrapped (<literal>title_scroll=%F</literal>) or scrolled (<literal>title_scroll=%T</literal>).
                     </para>
                 </listitem>
             </varlistentry>
             <varlistentry>
-                <term>Tag</term>
+                <term>TooltipString</term>
                 <listitem>
-                    <para>String</para>
-                    <para>This property is generally used to identify the control. It
-                        allows to give it a "name". Mainly used in conjunction with
-                        <literal>findobj()</literal>.
+                    <para>String or String vector</para>
+                    <para>
+                        This property represents the text of the uicontrol tooltip appearing when the mouse is over the uicontrol.
                     </para>
                 </listitem>
             </varlistentry>
                     </para>
                     <itemizedlist>
                         <listitem>
-                            <para>CheckBoxes, Radio buttons: value is set to Max (see above)
+                            <para>
+                                <literal>checkbox</literal> and <literal>radiobutton</literal> uicontrols: value is set to Max (see above)
                                 when on and Min when off.
                             </para>
                         </listitem>
                         <listitem>
-                            <para>ListBoxes, PopupMenus: value is a vector of indexes
-                                corresponding to the indexes of the selected entries in the
-                                list. 1 is the first item of the list.
+                            <para>
+                                <literal>listbox</literal> and <literal>popupmenu</literal> uicontrols: value is a vector of indexes
+                                corresponding to the indexes of the selected entries in the list. 1 is the first item of the list.
                             </para>
                         </listitem>
                         <listitem>
-                            <para>Sliders: value indicated by the slider bar.</para>
+                            <para>
+                                <literal>slider</literal> and <literal>spinner</literal> uicontrols: value indicated by the component.
+                            </para>
                         </listitem>
                         <listitem>
                             <para>
-                                Images: value is used to set some image properties <literal>[X-Scale Y-Scale X-Shear Y-Shear RotationAngle]</literal>
+                                <literal>layer</literal> and <literal>tab</literal> uicontrols: index of displayed component.
+                            </para>
+                        </listitem>
+                        <listitem>
+                            <para>
+                                <literal>image</literal> uicontrols: value is used to set some image properties <literal>[X-Scale Y-Scale X-Shear Y-Shear RotationAngle]</literal>
                             </para>
                         </listitem>
                     </itemizedlist>
             </member>
         </simplelist>
     </refsection>
+    <refsection>
+        <title>History</title>
+        <revhistory>
+            <revision>
+                <revnumber>5.5.0</revnumber>
+                <revremark>
+                    <para>
+                        Properties added and updated:
+                    </para>
+                    <itemizedlist>
+                        <listitem>Border property added.</listitem>
+                        <listitem>Scrollable property added.</listitem>
+                        <listitem>Groupname property added.</listitem>
+                        <listitem>Icon property added.</listitem>
+                        <listitem>Margins property added.</listitem>
+                        <listitem>Layout property added.</listitem>
+                        <listitem>Layout_properties property added.</listitem>
+                        <listitem>
+                            String property is now used to set colors on <literal>listbox</literal> and <literal>combobox</literal> uicontrols.
+                        </listitem>
+                        <listitem>Backgroundcolor and Foregroundcolor properties now manage Operating System specific values.</listitem>
+                    </itemizedlist>
+                </revremark>
+            </revision>
+        </revhistory>
+    </refsection>
 </refentry>