Improve description of callback_type property in uicontrol_properties help page.
[scilab.git] / scilab / modules / gui / help / en_US / uicontrol_properties.xml
1 <?xml version="1.0" encoding="UTF-8"?>
2 <refentry xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink" xmlns:svg="http://www.w3.org/2000/svg" xmlns:ns4="http://www.w3.org/1999/xhtml" xmlns:mml="http://www.w3.org/1998/Math/MathML" xmlns:db="http://docbook.org/ns/docbook" xmlns:scilab="http://www.scilab.org" xml:id="uicontrol_properties" xml:lang="en">
3     <refnamediv>
4         <refname>uicontrol properties</refname>
5         <refpurpose>Description of the uicontrol properties.</refpurpose>
6     </refnamediv>
7     <refsection>
8         <title>Description</title>
9         <para>
10             These properties can be set using the <link linkend="set">set</link> or <link linkend="uicontrol">uicontrol</link>
11             functions and their value can be obtained with the <link linkend="get">get</link>.
12         </para>
13     </refsection>
14     <refsection>
15         <title>Properties</title>
16         <variablelist>
17             <varlistentry>
18                 <term>BackgroundColor</term>
19                 <listitem>
20                     <para>[1,3] real vector or string</para>
21                     <para>Background color of the uicontrol. A color is specified as
22                         Red, Green and Blue values. Those values are real in [0,1]. The
23                         color can be given as a real vector, ie [R,G,B] or a string where
24                         each value is separated by a "|", ie "R|G|B".
25                     </para>
26                     <para>
27                         Setting this property to <literal>[-1 -1 -1]</literal> will let the look and feel set the default background color.
28                     </para>
29                 </listitem>
30             </varlistentry>
31             <varlistentry>
32                 <term>Border</term>
33                 <listitem>
34                     <para>A Border object.</para>
35                     <para>
36                         Only used for <literal>frame</literal> style uicontrols, this object is created using <link linkend="createBorder">createBorder</link>.
37                     </para>
38                     <para>
39                         Setting this value to <literal>[]</literal> removes the border of the frame.
40                     </para>
41                 </listitem>
42             </varlistentry>
43             <varlistentry>
44                 <term>Callback</term>
45                 <listitem>
46                     <para>String</para>
47                     <para>Instruction evaluated by the Scilab interpreter when an uicontrol is activated (for example when you click on a button).</para>
48                     <para>
49                         This property is not used for <literal>layer</literal>, <literal>frame</literal> and <literal>text</literal> style uicontrols.
50                     </para>
51                 </listitem>
52             </varlistentry>
53             <varlistentry>
54                 <term>Callback_Type</term>
55                 <listitem>
56                     <para>Scalar</para>
57                     <para>The type of callback transmitted to the uicontrol (see example below).</para>
58                     <itemizedlist>
59                         <listitem>
60                             <para>
61                                 <literal>-1</literal> none (callback desactivated)
62                             </para>
63                         </listitem>
64                         <listitem>
65                             <para>
66                                 <literal>0</literal> (by default) or <literal>2</literal> a non prioritary, interruptible Scilab instruction
67                             </para>
68                             <para>
69                                 <literal>10</literal> or <literal>12</literal> a prioritary, non-interruptible Scilab instruction
70                             </para>
71                         </listitem>
72                         <listitem>
73                             <para>
74                                 <literal>1</literal> a C or a Fortran function
75                             </para>
76                         </listitem>
77                     </itemizedlist>
78                 </listitem>
79             </varlistentry>
80             <varlistentry>
81                 <term>Constraints</term>
82                 <listitem>
83                     <para>A Constraints object.</para>
84                     <para>
85                         This object is created using <link linkend="createConstraints">createConstraints</link>
86                         and describes the constraints on the position and size of the uicontrol regarding to its parent.
87                     </para>
88                     <para>
89                         Setting this value to <literal>[]</literal> clears the constraints.
90                     </para>
91                 </listitem>
92             </varlistentry>
93             <varlistentry>
94                 <term>Enable</term>
95                 <listitem>
96                     <para>{on} | off</para>
97                     <para>
98                         Enable or disable the uicontrol. If this property is set to <literal>"on"</literal> (default), the uicontrol is operational,
99                         but if this property is set to <literal>"off"</literal>, the uicontrol will not respond to the mouse actions and will be grayed out.
100                     </para>
101                 </listitem>
102             </varlistentry>
103             <varlistentry>
104                 <term>FontAngle</term>
105                 <listitem>
106                     <para>{normal} | italic | oblique</para>
107                     <para>For a control containing some text, this property sets the slant of the font.</para>
108                 </listitem>
109             </varlistentry>
110             <varlistentry>
111                 <term>FontSize</term>
112                 <listitem>
113                     <para>Scalar</para>
114                     <para>For a control containing some text, this property sets the size of the font in FontUnits.
115                     </para>
116                 </listitem>
117             </varlistentry>
118             <varlistentry>
119                 <term>FontUnits</term>
120                 <listitem>
121                     <para>{points} | pixels | normalized</para>
122                     <para>For a control containing some text, this property sets the
123                         units with which the FontSize is specified.
124                     </para>
125                 </listitem>
126             </varlistentry>
127             <varlistentry>
128                 <term>FontWeight</term>
129                 <listitem>
130                     <para>light | {normal} | demi | bold</para>
131                     <para>For a control containing some text, this property sets the
132                         weight of the used font.
133                     </para>
134                 </listitem>
135             </varlistentry>
136             <varlistentry>
137                 <term>FontName</term>
138                 <listitem>
139                     <para>String</para>
140                     <para>Used to choose the name of the font selected to display the
141                         text of the control.
142                     </para>
143                 </listitem>
144             </varlistentry>
145             <varlistentry>
146                 <term>ForegroundColor</term>
147                 <listitem>
148                     <para>[1,3] real vector or string</para>
149                     <para>Foreground color of the uicontrol. A color is specified as
150                         Red, Green and Blue values. Those values are real in [0,1]. The
151                         color can be given as a real vector, ie [R,G,B] or a string where
152                         each value is separated by a "|", ie "R|G|B".
153                     </para>
154                     <para>
155                         Setting this property to <literal>[-1 -1 -1]</literal> will let the look and feel set the default foreground color.
156                     </para>
157                 </listitem>
158             </varlistentry>
159             <varlistentry>
160                 <term>Groupname</term>
161                 <listitem>
162                     <para>String</para>
163                     <para>
164                         Used for <literal>radiobutton</literal> and <literal>checkbox</literal> style uicontrols,
165                         this property allow to manage uicontrols of the same group as a whole. For example, <literal>checkbox</literal> uicontrols of a group
166                         will manage selection unicity automatically.
167                     </para>
168                 </listitem>
169             </varlistentry>
170             <varlistentry>
171                 <term>HorizontalAlignment</term>
172                 <listitem>
173                     <para>left | {center} | right</para>
174                     <para>Set text horizontal alignment in the uicontrol.</para>
175                 </listitem>
176             </varlistentry>
177             <varlistentry>
178                 <term>Icon</term>
179                 <listitem>
180                     <para>String.</para>
181                     <para>
182                         This property represents the relative (to <link linkend="pwd">Scilab working directory</link>) or absolute path of the image file to be
183                         used as icon for a <literal>pushbutton</literal> or <literal>text</literal> uicontrol.
184                     </para>
185                     <para>
186                         For <literal>frame</literal> uicontrols in <literal>tab</literal> uicontrols, the icon property sets the icon of its sheet.
187                     </para>
188                 </listitem>
189             </varlistentry>
190             <varlistentry>
191                 <term>Layout: </term>
192                 <listitem>
193                     <para>
194                         This property sets the layout used to dispose <literal>frame</literal> uicontrols children.
195                         See <link linkend="layout">layout</link> page for more information about available layouts.
196                     </para>
197                 </listitem>
198             </varlistentry>
199             <varlistentry>
200                 <term>Layout_options: </term>
201                 <listitem>
202                     <para>
203                         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.
204                     </para>
205                 </listitem>
206             </varlistentry>
207             <varlistentry>
208                 <term>ListboxTop</term>
209                 <listitem>
210                     <para>Scalar</para>
211                     <para>
212                         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.
213                     </para>
214                 </listitem>
215             </varlistentry>
216             <varlistentry>
217                 <term>Margins</term>
218                 <listitem>
219                     <para>[1,4] real vector.</para>
220                     <para>
221                         Sets an empty space around the uicontrol under the form <literal>[top, left, bottom, right]</literal> (in pixels).
222                     </para>
223                 </listitem>
224             </varlistentry>
225             <varlistentry>
226                 <term>Max</term>
227                 <listitem>
228                     <para>Scalar</para>
229                     <para>Specifies the largest value the "Value" property can be set
230                         to. It has however different meaning on each uicontrol:
231                     </para>
232                     <itemizedlist>
233                         <listitem>
234                             <para>
235                                 <literal>checkbox</literal> and <literal>radiobutton</literal> uicontrols: Max is the value the "Value" property take when control is checked.
236                             </para>
237                         </listitem>
238                         <listitem>
239                             <para>
240                                 <literal>slider</literal> and <literal>spinner</literal> uicontrols: Maximum value of the component.
241                             </para>
242                         </listitem>
243                         <listitem>
244                             <para>
245                                 <literal>listbox</literal> uicontrols: if (Max-Min)&gt;1 the list allows multiple selection.
246                             </para>
247                         </listitem>
248                         <listitem>
249                             <para>
250                                 <literal>edit</literal> uicontrols: if (Max-Min)&gt;1 the edit allows multiple line edition.
251                             </para>
252                         </listitem>
253                     </itemizedlist>
254                 </listitem>
255             </varlistentry>
256             <varlistentry>
257                 <term>Min</term>
258                 <listitem>
259                     <para>Scalar</para>
260                     <para>Specifies the lowest value the "Value" property can be set to.
261                         It has however different meaning on each uicontrol:
262                     </para>
263                     <itemizedlist>
264                         <listitem>
265                             <para>
266                                 <literal>checkbox</literal> and <literal>radiobutton</literal> uicontrols: Min is the value the "Value" property take when control is unchecked.
267                             </para>
268                         </listitem>
269                         <listitem>
270                             <para>
271                                 <literal>slider</literal> and <literal>spinner</literal> uicontrols: Minimum value of the component.
272                             </para>
273                         </listitem>
274                         <listitem>
275                             <para>
276                                 <literal>listbox</literal> uicontrols: if (Max-Min)&gt;1 the list allows multiple selection.
277                             </para>
278                         </listitem>
279                         <listitem>
280                             <para>
281                                 <literal>edit</literal> uicontrols: if (Max-Min)&gt;1 the edit allows multiple line edition.
282                             </para>
283                         </listitem>
284                     </itemizedlist>
285                 </listitem>
286             </varlistentry>
287             <varlistentry>
288                 <term>Parent</term>
289                 <listitem>
290                     <para>Handle</para>
291                     <para>Handle of the uicontrol parent. Changing this property allows
292                         to move a control from a figure to another.
293                     </para>
294                 </listitem>
295             </varlistentry>
296             <varlistentry>
297                 <term>Position</term>
298                 <listitem>
299                     <para>[1,4] real vector or string.</para>
300                     <para>This property is used to set or get the geometrical
301                         configuration of a control. It is a vector [x y w h] where the
302                         letters stand for the x location of the left bottom corner, the y
303                         location of the left bottom corner, the width and the height of the
304                         uicontrol or a character string where each value is separated by a
305                         "|", ie "x|y|w|h". The units are determined by the "Units"
306                         property.
307                     </para>
308                     <para>The width and height values determine the orientation of sliders. If width is greater than height, then the slider is oriented horizontally, otherwise the slider is oriented vertically.</para>
309                 </listitem>
310             </varlistentry>
311             <varlistentry>
312                 <term>Relief</term>
313                 <listitem>
314                     <para>{default} | flat | groove | raised | ridge | solid | sunken</para>
315                     <para>
316                         Appearance of the border of the uicontrol. <literal>"default"</literal> means that the application look and feel will be used to set the relief.
317                     </para>
318                     <para>When using the deprecated skin for uicontrols, default values are related to uicontrol style:</para>
319                     <itemizedlist>
320                         <listitem>
321                             <para>
322                                 <literal>pushbutton</literal> uicontrols: the default value for "Relief" property is "raised".
323                             </para>
324                         </listitem>
325                         <listitem>
326                             <para>
327                                 <literal>edit</literal> uicontrols: the default value for "Relief" property is "sunken".
328                             </para>
329                         </listitem>
330                         <listitem>
331                             <para>Other uicontrols: the default value for "Relief" property is "flat".</para>
332                         </listitem>
333                     </itemizedlist>
334                 </listitem>
335             </varlistentry>
336             <varlistentry>
337                 <term>Scrollable</term>
338                 <listitem>
339                     <para>Boolean.</para>
340                     <para>
341                         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>).
342                     </para>
343                     <para>
344                         For <literal>frame</literal> this value must be set at creation.
345                     </para>
346                 </listitem>
347             </varlistentry>
348             <varlistentry>
349                 <term>SliderStep</term>
350                 <listitem>
351                     <para>[1,2] real vector</para>
352                     <para>[small big], the small step represents the movement achieved
353                         when clicking on the slider trough or tapping on the keyboard arrows
354                         (when the slider has focus); the big step is the amount moved when
355                         using Ctrl-keyboard-arrows. If the big step is omitted, it is
356                         defaulted to 1/10 of the scale.
357                     </para>
358                     <para>
359                         For <literal>spinner</literal> uicontrol, the first value of this property is used as fixed step.
360                     </para>
361                 </listitem>
362             </varlistentry>
363             <varlistentry>
364                 <term>String</term>
365                 <listitem>
366                     <para>String.</para>
367                     <para>
368                         This property represents the text appearing in a uicontrol
369                         (Except for Frame and Slider styles). For tables, the value is a string matrix. For ListBoxes and PopupMenus,
370                         the value can be a vector of string or a string where the items are
371                         separated by a "|". For Text uicontrols, this string can contain HTML code to format the text.
372                     </para>
373                     <itemizedlist>
374                         <listitem>
375                             <para>
376                                 For <literal>pushbutton</literal> or <literal>text</literal> uicontrols, if the text is enclosed between two $ (dollar sign), then it will be
377                                 considered as a LaTeX expression, and if it is enclosed between &lt; and &gt;, it will be considered
378                                 as a MathML one.
379                             </para>
380                         </listitem>
381                         <listitem>
382                             <para>
383                                 For <literal>layer</literal> and <literal>tab</literal> uicontrols, the value specifies the tag of the selected child.
384                             </para>
385                         </listitem>
386                         <listitem>
387                             <para>
388                                 For <literal>image</literal> uicontrols, the value specifies the path of the image file.
389                             </para>
390                         </listitem>
391                         <listitem>
392                             <para>
393                                 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>.
394                             </para>
395                         </listitem>
396                         <listitem>
397                             <para>
398                                 For <literal>listbox</literal> and <literal>popupmenu</literal> uicontrols which manage colors selection, icons, background
399                                 and foreground colors, the <literal>String</literal> property can be set to a matrix matching the format:
400                                 <literal>["#color1", "Item1", "#background1", "#foreground1"; "#color2", "Item2", ..., ...]</literal>
401                                 <literal>["icon1", "Item1", "#background1", "#foreground1"; "icon2", "Item2", ..., ...]</literal>
402                                 with <literal>"#color1"</literal>, <literal>"#background1"</literal> and <literal>"#foreground1"</literal> in HTML format <literal>#XXXXXX</literal>.
403                                 Then the component will display a colored box or icon on the left of the associated string,
404                                 and different background/foreground colors for items.
405                             </para>
406                         </listitem>
407                     </itemizedlist>
408                     
409                 </listitem>
410             </varlistentry>
411             <varlistentry>
412                 <term>Tag</term>
413                 <listitem>
414                     <para>String</para>
415                     <para>This property is generally used to identify the control. It
416                         allows to give it a "name". Mainly used in conjunction with
417                         <literal>findobj()</literal>.
418                     </para>
419                 </listitem>
420             </varlistentry>
421             <varlistentry>
422                 <term>Title_position</term>
423                 <listitem>
424                     <para>{top} | left | bottom | right</para>
425                     <para>
426                         The position of the tabs of a <literal>tab</literal> style uicontrol.
427                     </para>
428                 </listitem>
429             </varlistentry>
430             <varlistentry>
431                 <term>Title_scroll</term>
432                 <listitem>
433                     <para>Boolean</para>
434                     <para>
435                         Indicates whether the tabs of a <literal>tab</literal> style uicontrol
436                         must be wrapped (<literal>title_scroll=%F</literal>) or scrolled (<literal>title_scroll=%T</literal>).
437                     </para>
438                 </listitem>
439             </varlistentry>
440             <varlistentry>
441                 <term>TooltipString</term>
442                 <listitem>
443                     <para>String or String vector</para>
444                     <para>
445                         This property represents the text of the uicontrol tooltip appearing when the mouse is over the uicontrol.
446                     </para>
447                 </listitem>
448             </varlistentry>
449             <varlistentry>
450                 <term>Units</term>
451                 <listitem>
452                     <para>{points} | pixels | normalized</para>
453                     <para>Set the units used to specify the "Position" property.</para>
454                 </listitem>
455             </varlistentry>
456             <varlistentry>
457                 <term>Userdata</term>
458                 <listitem>
459                     <para>Scilab data</para>
460                     <para>This can be used to associate some Scilab objects
461                         (string,string matrix, matrix mxn) to an uicontrol.
462                     </para>
463                 </listitem>
464             </varlistentry>
465             <varlistentry>
466                 <term>Value</term>
467                 <listitem>
468                     <para>Scalar or vector</para>
469                     <para>Value of the uicontrol. The exact meaning depends on the style
470                         of the uicontrol:
471                     </para>
472                     <itemizedlist>
473                         <listitem>
474                             <para>
475                                 <literal>checkbox</literal> and <literal>radiobutton</literal> uicontrols: value is set to Max (see above)
476                                 when on and Min when off.
477                             </para>
478                         </listitem>
479                         <listitem>
480                             <para>
481                                 <literal>listbox</literal> and <literal>popupmenu</literal> uicontrols: value is a vector of indexes
482                                 corresponding to the indexes of the selected entries in the list. 1 is the first item of the list.
483                             </para>
484                         </listitem>
485                         <listitem>
486                             <para>
487                                 <literal>slider</literal> and <literal>spinner</literal> uicontrols: value indicated by the component.
488                             </para>
489                         </listitem>
490                         <listitem>
491                             <para>
492                                 <literal>layer</literal> and <literal>tab</literal> uicontrols: index of displayed component.
493                             </para>
494                         </listitem>
495                         <listitem>
496                             <para>
497                                 <literal>image</literal> uicontrols: value is used to set some image properties <literal>[X-Scale Y-Scale X-Shear Y-Shear RotationAngle]</literal>
498                             </para>
499                         </listitem>
500                     </itemizedlist>
501                 </listitem>
502             </varlistentry>
503             <varlistentry>
504                 <term>Verticalalignment</term>
505                 <listitem>
506                     <para>top | {middle} | bottom</para>
507                     <para>Set text vertical alignment in the uicontrol. This property
508                         has only effect with Text and CheckBoxes styles.
509                     </para>
510                 </listitem>
511             </varlistentry>
512             <varlistentry>
513                 <term>Visible</term>
514                 <listitem>
515                     <para>{on} | off</para>
516                     <para>
517                         Set the visibility of the uicontrol. If this property is set to <literal>"on"</literal> (default), the uicontrol is visible,
518                         but if this property is set to <literal>"off"</literal>, the uicontrol will not appear in its parent figure.
519                     </para>
520                 </listitem>
521             </varlistentry>
522         </variablelist>
523     </refsection>
524     <refsection>
525         <title>Example for callback_type property</title>
526         <programlisting role="example"><![CDATA[
527 function counter_start()
528     // Callback called after a click on start pushbutton
529     global Stop
530     Stop=%f;
531     while %t
532         i = evstr(get("count", "string"));
533         set("count", "string", string(i+1));
534         if Stop then
535             break
536         end
537     end
538 endfunction
539
540 function counter_stop()
541     // Callback called after a click on stop pushbutton
542     global Stop
543     Stop=%t
544 endfunction
545
546 function counter_reinit()
547     // Callback called after a click on reset pushbutton
548     Stop=%t
549     set("count", "string", "0");
550 endfunction
551
552
553 counter_main_fig = figure( ...
554 "dockable", "off", ...
555 "infobar_visible", "off", ...
556 "toolbar_visible", "off", ...
557 "toolbar", "none", ...
558 "menubar_visible", "off", ...
559 "menubar", "none", ...
560 "layout", "none", ...
561 "visible", "off", ...
562 "resize", "off", ...
563 "figure_position", [0 0], ...
564 "axes_size", [400, 150], ...
565 "figure_name", "Counter", ...
566 "layout", "gridbag", ...
567 "tag", "counter_main_figure");
568
569
570 // Counter frame
571 counter_frame = uicontrol(counter_main_fig, ...
572 "layout", "gridbag", ...
573 "style", "frame", ...
574 "constraints", createConstraints("gridbag", [1, 1, 1, 1], [1, 0.5], "both"));
575
576 uicontrol(counter_frame, ...
577 "style", "text", ...
578 "string", "Counter : ", ...
579 "constraints", createConstraints("gridbag", [1, 1, 1, 1], [0.5, 1], "horizontal", "center"), ...
580 "margins", [5 5 5 5], ...
581 "horizontalAlignment", "center");
582
583 uicontrol(counter_frame, ...
584 "style", "text", ...
585 "string", "0", ...
586 "constraints", createConstraints("gridbag", [2, 1, 1, 1], [1, 1], "horizontal", "center"), ...
587 "tag", "count", ...
588 "margins", [5 5 5 5]);
589
590 // Buttons frame
591 buttons_frame = uicontrol(counter_main_fig, ...
592 "layout", "gridbag", ...
593 "style", "frame", ...
594 "constraints", createConstraints("gridbag", [1, 2, 1, 1], [1, 1], "both"));
595
596 // The associated callback needs to be interruptible (when clicking on stop or reset for example)
597 uicontrol("parent", buttons_frame, ...
598 "Style"     , "pushbutton", ...
599 "String"    , "Start", ...
600 "callback"  , "counter_start()", ...
601 "margins", [5 5 5 5], ...
602 "constraints", createConstraints("gridbag", [1, 1, 1, 1], [1, 1], "horizontal", "center"));
603
604 // The associated callback needs to have priority in order to interrupt the current callback (in other words to stop the counter)
605 uicontrol("parent", buttons_frame, ...
606 "Style"     , "pushbutton", ...
607 "String"    , "Stop", ...
608 "callback"  , "counter_stop()", ...
609 "callback_type", 10, ...
610 "constraints", createConstraints("gridbag", [2, 1, 1, 1], [1, 1], "horizontal", "center"), ...
611 "margins", [5 5 5 5]);
612
613 // The same for the callback which reset the counter: it must have the priority over the callback which has started the counter
614 uicontrol("parent", buttons_frame, ...
615 "Style"     , "pushbutton", ...
616 "String"    , "Reset", ...
617 "callback"  , "counter_reinit()", ...
618 "callback_type", 10, ...
619 "constraints", createConstraints("gridbag", [3, 1, 1, 1], [1, 1], "horizontal", "center"), ...
620 "margins", [5 5 5 5]);
621
622 counter_main_fig.visible = "on";
623  ]]></programlisting>
624     </refsection>
625     <refsection role="see also">
626         <title>See Also</title>
627         <simplelist type="inline">
628             <member>
629                 <link linkend="set">set</link>
630             </member>
631             <member>
632                 <link linkend="get">get</link>
633             </member>
634             <member>
635                 <link linkend="uicontrol">uicontrol</link>
636             </member>
637         </simplelist>
638     </refsection>
639     <refsection>
640         <title>History</title>
641         <revhistory>
642             <revision>
643                 <revnumber>6.0.0</revnumber>
644                 <revremark>
645                     <para>
646                         By default, callback_type property is now interruptible but non prioritary.
647                     </para>
648                 </revremark>
649             </revision>
650             <revision>
651                 <revnumber>5.5.0</revnumber>
652                 <revremark>
653                     <para>
654                         Properties added and updated:
655                     </para>
656                     <itemizedlist>
657                         <listitem>Border property added.</listitem>
658                         <listitem>Scrollable property added.</listitem>
659                         <listitem>Groupname property added.</listitem>
660                         <listitem>Icon property added.</listitem>
661                         <listitem>Margins property added.</listitem>
662                         <listitem>Layout property added.</listitem>
663                         <listitem>Layout_properties property added.</listitem>
664                         <listitem>
665                             String property is now used to set colors on <literal>listbox</literal> and <literal>combobox</literal> uicontrols.
666                         </listitem>
667                         <listitem>Backgroundcolor and Foregroundcolor properties now manage Operating System specific values.</listitem>
668                     </itemizedlist>
669                 </revremark>
670             </revision>
671         </revhistory>
672     </refsection>
673 </refentry>