View source for Programmer Guide/Shell Items/Dialog/Dialog Controls

{{DISPLAYTITLE:{{SUBPAGENAME}}}}
The {{STX}} dialog implementation supports the control types listed below.

__TOC__

== Common arguments ==

The following parameters have the same meaning for all the <code>SET DIALOG</code> <var>control</var> commands.

{| class="keinrahmen"
| valign="top" | <var>index</var>
| The control index (a number in the range <code>0</code>&hellip;<code>999</code>). The index is used in other setup commands and in messages to identify the control within the dialog.
|-
| valign="top" | <var>row</var>
| The position of the upper left corner of the control on the y-axis in dialog units
|-
| valign="top" | <var>col</var>
| The position of the upper left corner of the control on the x-axis in dialog units.
|-
| valign="top" | <var>text</var>
| The control caption. This is displayed inside or near to the control depending on the control type and the caption positioning.
|-
| valign="top" | <var>var1</var>
| The name of the first variable or item which is bound the the control. See the individual control syntax for more details.
|-
| valign="top" | <var>width</var>
| The width of the control in dialog characters.
|-
| valign="top" | <var>height</var>
| The height of the control in dialog characters.
|-
| valign="top" | <var>var2</var>
| The name of the second variable or item which is bound the the control. See the individual control syntax for more details.
|-
| valign="top" | <var>fg</var>
| The foreground (text) color.
|-
| valign="top" | <var>bg</var>
| The background color. This is only used for captions and <code>STATIC</code> controls.
|-
| valign="top" | <var>font</var>
| The font to use for this control. This overrides the dialog font.
|-
| valign="top" | <code>/A</code>, <code>/L</code>, <code>/R</code>, <code>/B</code> or <code>/C</code>
| For controls with a caption, you can set the position of the caption in relation to the control.
|-
| valign="top" | <code>/Above</code>, <code>/Left</code>, <code>/Right</code>, <code>/Below</code> or <code>/Center</code>
| A dialog can coexist with graphs inside a display (dialog+graphs) or can be the attached exclusively to a display (dialog-only). If an undefined command is applied to a dialog, the command is directly forwarded to the display owning the dialog. This means that all commands defined for display items can also be applied to dialog items.
|}

== Dialog Caption Position ==

For the control types <code>STATIC</code>, <code>BUTTON</code> and <code>GROUPBOX</code> the caption is displayed inside the control window. For all other types, the position of the caption can be set by one of the options /Above, /Left (default) or /Right. The same options plus the option /Center are used to set the text alignment for <code>STATIC</code> controls.

For controls without their own caption (inside the control), the caption is implemented as a separate static control which is bound to the control.

== Dialog Control Resizing And Positioning ==

If the size of the display window is changed, the control positions and sizes remain unchanged. The option /Window can be used to enable resizing/repositioning for some controls (changes are relative to the change in the display window):

=== Format 1: <code>/Window=<var>xy</var></code> ===

<var>x</var> and <var>y</var> are single characters; each addresses two control window attributes of one dimension

{|class="keinrahmen"
! align="center" | Value for <var>x</var>
! align="left" style="padding-left:2em;" | Meaning
|-
| align="center" | <code>x</code>
| style="padding-left:2em;" | 50% change of x position
|-
| align="center" | <code>X</code>
| style="padding-left:2em;" | 100% change of x position
|-
| align="center" | <code>w</code>
| style="padding-left:2em;" | 50% change of width
|-
| align="center" | <code>W</code>
| style="padding-left:2em;" | 100%change of width
|-
| align="center" | <code>b</code>
| style="padding-left:2em;" | 50% change of x position and width
|-
| align="center" | <code>B</code>
| style="padding-left:2em;" | 100% change of x position and width
|}


{|class="keinrahmen"
! align="left" | Value for <var>y</var>
! align="left" style="padding-left:2em;" | Meaning
|-
| align="center" | <code>y</code>
| style="padding-left:2em;" | 50% change of y position
|-
| align="center" | <code>Y</code>
| style="padding-left:2em;" | 100% change of y position
|-
| align="center" | <code>h</code>
| style="padding-left:2em;" | 50% change of height
|-
| align="center" | <code>H</code>
| style="padding-left:2em;" | 100% change of height
|-
| align="center" | <code>b</code>
| style="padding-left:2em;" | 50% change of y position and height
|-
| align="center" | <code>B</code>
| style="padding-left:2em;" | 100% change of y position and height
|}

=== Format2: <code>/Window=<var>xywh</var></code> ===

Each of the characters <var>x</var>, <var>y</var>, <var>w</var> and <var>h</var> addresses one attribute of the control window (x/y position, width, height) and can be set to <code>h</code> (half change), <code>f</code> (full change) or <code>a</code> (automatic alignment).

For example, if you want to include an edit box in a dialog within a resizeable display, and you want the edit box to resize with the display, you can use the combination <code>/W=**ff</code> as follows:

 $#dlg $#index edit $#row $#col 'caption' $#tEdit $#width $#height /W=**ff

== Available Dialog Controls ==

=== BUTTON ===

[[File:dialog_control_button.png]]

 SET <var>dialog index</var> BUTTON <var>row col text</var> [<var>* width height * fg bg font</var>] [ /D ]

{| class="keinrahmen"
| valign="top" | <code>/Defaultbutton</code>
| Make the button the default button (activated when the dialog is displayed for the first time). A more general way (for all controls) to activate a control is implemented through the command: <code>SET dialog index FOCUS</code>
|}

See [[Programmer_Guide/Shell_Items/Dialog/Dialog_Controls#Common_arguments|Common arguments]] for a description of the parameters not described here.

Note that you may display an image in a button using the <code>[[Programmer_Guide/Shell_Items/Dialog/SET_DIALOG#BITMAP|SET dialog BITMAP]]</code> command.

=== CHECKBOX ===

[[File:dialog_control_checkbox.png]]

 SET <var>dialog index</var> CHECKBOX <var>row col text var1</var> [<var>width height * fg bg font</var>][ /L|R ]

A checkbox control. The checkbox sends an <code>UPDATE</code> message when it is checked or unchecked.

{| class="keinrahmen"
| valign="top" | <var>var1</var>
|The name of the checkbox status variable (<code>0</code>=unchecked, <code>1</code>=checked, <code>2</code>=checked+grayed).
|-
| valign="top" | <code>/3</code>
| Enable third state (checked+grayed); a normal checkbox supports only the states checked and unchecked.
|}

See [[Programmer_Guide/Shell_Items/Dialog/Dialog_Controls#Common_arguments|Common arguments]] for a description of the parameters not described here.

=== COMBOBOX ===

[[File:dialog_control_combobox.png]]

 SET <var>dialog index</var> COMBOBOX <var>row col text var1 w h var2</var> [<var>fg bg font</var>] [ /E [ /I|N ]] [ /T ] [ /A|L|R ]

{| class="keinrahmen"
| valign="top" | <var>var1</var>
| The name of the variable to contain the input field text (/Editenabled) or the name of the variable to contain the index of selected item in the list.
|-
| valign="top" | <var>var2</var>
| The name of the table item (if /Table is specified) containing the combobox list (with one item per entry) or a variable containing a blank or tab separated list of words.
|-
| valign="top" | <code>/Editenable</code>
| Allow input field editing. If this option is used, the combobox entry can be edited and the string is stored in <var>var1</var>.
|-
| valign="top" | <code>/Integer</code> or <code>/Number</code>
| Only available if <code>/Edit</code> is specified. See <code>/Edit/<code> for details.
|-
| valign="top" | <var>/Table</var>
| If specified, <var>var2</var> must be the id of a simple table item containing the list to be displayed (one entry per row).
|}

See [[Programmer_Guide/Shell_Items/Dialog/Dialog_Controls#Common_arguments|Common arguments]] for a description of the parameters not described here.

=== EDIT ===

[[File:dialog_control_edit.png]]

 SET <var>dialog</var> <var>index</var> EDIT <var>row</var> <var>col</var> <var>caption</var> <var>var1</var> [ <var>width</var> <var>height</var> <var>var2</var>|* <var>fg</var> <var>bg</var> <var>font</var> ] [ /A|L|R ] [ /F[=PCAFS] ] 

{|class="keinrahmen"
| valign="top" | <var>var1</var>
| The name of the variable or table (for multiline edit; <code>/Multiline</code>) to store the edit string in.
|-
| valign="top" | <var>var2</var>
| This is an optional table setting advanced properties of the edit control (see below). If you don't need to set advanced properties, you may indicate so by supplying the asterisk, &quot;<code>*</code>&quot;, instead of a table.
|}

=== Advanced properties of the EDIT control ===

A large number of advanced properties (i.e., settings) for an edit control may be set using a parameter table supplied as the <var>var2</var> argument (see above). If you don't need these advanced features, you may indicate so by supplying an asterisk, &quot;<code>*</code>&quot;, instead of a table.

The parameter table used for setting the advanced properties of an edit control must be an extended table containing exactly two string columns that must be named &quot;parameter&quot; and&quot;string&quot;. You may create such a table using the following {{STX}} statement:

 #tab := new table * * /E string:parameter string:string

For each advanced property to set, you need to store a respective entry (i.e., row) in the table. Each such entry has to contain the name of the respective property in the <code>name</code> column, and its desired value in the <code>string</code> column.

The following advanced parameters are supported:

{|class="keinrahmen"
! align="left" | Parameter
! align="left" | Value(s)
|-
! align="left" | <var>name</var> field
! align="left" | <var>string</var> field
|-
| <code>append</code>
| <code>on</code> or <code>off</code>
|-
| <code>breakpoints</code>
| <code>on</code> or <code>off</code>
|-
|<code>caret</code>
|<code>on</code> or <code>off</code>
|-
|<code>clear</code>
| If specified, clears the contents of the edit control. There is no argument to this parameter.
Example: <code>$#tSettings parameter clear /T</code>
|-
|<code>colorOutput</code>
|Sets the color for the shell output for edits of type <code>cli</code>.
|-
|<code>colorInput</code>
|Sets the color for the input for edits of type <code>cli</code>.
|-
|<code>colorPrompt</code>
|Sets the color for the prompt for edits of type <code>cli</code>.
|-
|<code>colorBackground</code>
|Sets the color for the background for edits of type <code>cli</code>.
|-
|<code>colorCaret</code>
|Sets the color for the caret for edits of type <code>cli</code>.Example: <code>$#tSettings * parameter colorBackground string hlgray /t</code>Example: <code>$#tSettings * parameter colorPrompt string 0:250:128 /t</code>
|-
|<code>currentLine</code>
|<code>lineNumber</code>
|-
|<code>lineNumbers</code>
|<code>on</code> or <code>off</code>
|-
|<code>outputMode</code>
|The following values are supported:<code>overwrite</code> - overwrites old content with new content
<code>append</code> - appends new content to old content
<code>overwriteLastLine</code> - overwrites the last line
<code>newLine</code> - which appends new data on a new line

Example: <code>$#tSettings * parameter outputMode string overwriteLastLine /T</code>
|-
|<code>outputLineLimit</code>
| If set to a number higher than zero, the control will limit the number of lines displayed. This is particularly useful when using a "<code>log</code>" type edit box.
|-
| <code>prompt</code>
| the CLI prompt, e.g. <code>&quit;&gt;&nbsp;&quot;</code> or <code>&quot;#&nbsp;&quot;</code>
|-
|<code>readonly</code>
|<code>on|off</code>
|-
|<code>showLine</code>
|<code>lineNumber</code>
|-
|<code>type</code>
|The following values are supported:<code>edit</code> - a normal edit box
<code>log</code> - read-only, append mode, caret off
<code>code</code> - read-only, breakpoints on, linenumbers on, caret off and uses {{STX}} syntax highlighting
<code>cli</code> - the command line interface
|-
|<code>waitforinput</code>
|If set to "<code>on</code>", key messages will be passed on to the shell without the CLI processing them in any other way. This can, e.g., be used by the console getc command to wait for the user to input a character. When the key processing should continue, this parameter should be set to "<code>off</code>".
|}

:The parameters are ignored by the edit control unless the entry is tagged. Once applied, the tag is removed by the edit control, so you have to set the tag again if you want to change the parameter.

;<var>/Integer|Number</var>

:Input field must contain a valid float (/Number) or integer (/Integer) number or numeric expression; expressions are evaluated before assigned to <var>var1</var> (not applicable/available for the table <var>var1</var>)

;<var>/Password</var>

:Input is hidden; an asterisk '<code>*</code>' is displayed for each entered character

;<var>/Multiline</var>

:Allow multiline input.

;<var>/Keystroke</var>

:Send <code>[[Programmer Guide/Shell Items/Dialog/DISPLAY and DIALOG Messages|UPDATE]]</code> message to shell for each entered character; otherwise the update message is only sent if the input is completed (another control is selected).The enter key is a special case; for /Multiline edit boxes, the enter key is used for line breaks, whilst for single line edit boxes, the enter key sends a <code>[[Programmer Guide/Shell Items/Dialog/DISPLAY and DIALOG Messages|COMMAND]]</code> message (since {{STX}} version 3.6.0). Note that the enter key for a single line edit box also sends the same command as the default button (if one is defined - see <code>BUTTON</code>).

;<var>/F[=PCAFS]</var>

:If no modifier is specified, all keys are forwarded.

:Any combination of the modifiers is allowed. The modifiers have the following meaning:

:P - printable keys

:C - control keys (ctrl, shift, alt, alt-gr)

:A - action keys (left, right, esc, return etc.

:F - function keys (F1-F24)

:S - sticky keys (caps lock, num lock, scroll lock)

See [[Programmer_Guide/Shell_Items/Dialog/Dialog_Controls#Common_arguments|Common arguments]] for a description of the parameters not described here.

=== GROUPBOX ===

[[File:dialog_control_groupbox.png]]

<code>SET <var>dialog index</var> GROUPBOX <var>row col text</var> [<var>* w h * fg bg font</var> [<var>first last</var>]]</code>

The groupbox control draws a frame around the area <var>row</var>/<var>col</var>, <var>row</var>+<var>h</var>/<var>col</var>+<var>w</var>, or around the specified controls <var>first</var> to <var>last</var>. If the controls <var>first</var> and <var>last</var> are specified, they must already be defined and <var>row</var> and <var>col</var> are used as margins (<var>row</var> = top|bottom, <var>col</var> = left|right) and not as positions. The caption is displayed inside the top line of the frame.

See [[User Guide/Waveform Plot and Segmentation/Control Dialog|Dialog Controls]] for a description of parameters not described here.

=== LISTBOX ===

[[File:dialog_control_listbox.png]]

<code>SET <var>dialog index</var> LISTBOX <var>row col text var1 width height var2</var> [<var>fg bg font</var>] [ /Table [ /X ]][ /A|L|R ]</code>

With commands containing the option /Read, the selection status is copied to the tag flags of the table entries, but the entry content remains unchanged. Dialog commands with the option /Write writes table data and selection status to the control. Table entries are displayed in show format (see <code>SET TABLE CONFIG</code>).

;<var>var1</var>

:The name of the variable to store the index or the counter in.

;<var>var2</var>

:The name of a table item (/Table) or variable containing a blank separated list of items.

;<var>/Table</var>

:You must specify this option if <var>var2</var> is the name of a table containing the list items.

;<var>/X</var>

:The option /X stands for eXtended selection. Multiple items can be selected and <var>var1</var> is set to the number of selected items. This option is only applicable with the /Table option. If this option is not specified, only one item can be selected and <var>var1</var> contains the index of the selected item.

See [[User Guide/Waveform Plot and Segmentation/Control Dialog|Dialog Controls]] for a description of parameters not described here.

=== LISTVIEW ===

[[File:dialog_control_listview.png]]

<code>SET <var>dialog index</var> LISTVIEW <var>row col text var1 w h var2</var> [<var>fg bg font</var>]</code>

<code>/T [ /A|L|R ] [ /E ] [ /F[=PCAFS] ] [ /R=n ]</code>

The <code>LISTVIEW</code> control is a enhanced variant of the <code>LISTBOX</code>. It displays each table field in a separate column and has a built-in function for sorting tables. The data exchange is implemented in the same way as for the <code>LISTBOX</code>. Rows which are tagged in the table are used to initialize listview row selection, after which the table parameter's tags reflect the listview's selection.

;<var>var1</var>

:The name of the index or counter variable.

;<var>var2</var>

:The name of the extended table item containing list items

;<var>/T</var>

:This is a mandatory option.

;<var>/X</var>

:X stands for eXtended selection. If specified, more than one entry can be selected at one time. See <code>LISTBOX</code> for details.

;<var>/Header</var>

:If specified, column headers are displayed. Note that if you do not configure the <var>var2</var> table, then the field ids are used for the header text.

;<var>/Sort</var>

:If specified, column headers are displayed and can be used to sort the entries.

;<var>/Grid</var>

:If specified, grid lines are displayed between rows and columns

;<var>/J</var>

:If specified, columns are automatically sized to fit their widest entry.

;<var>/Centervertically</var>

:If specified, the selected entry is automatically centered vertically.

;<var>/E</var>

:If this flag is not set on creation, the ListView will not be editable regardless of the connected tables display attributes. See the example script <code>editabletable.sts</code> for a complete example.

;<var>/F[=PCAFS]</var>

:If no modifier is specified, all keys are forwarded.

:Any combination of the modifiers is allowed. The modifiers have the following meaning:

:P - printable keys

:C - control keys (ctrl, shift, alt, alt-gr)

:A - action keys (left, right, esc, return etc.)

:F - function keys (F1-F24)

:S - sticky keys (caps lock, num lock, scroll lock)

;<var>/R=n</var>

:If specified, 'n' determines the maximum number of lines of text which can be displayed in the listview.

See [[User Guide/Waveform Plot and Segmentation/Control Dialog|Dialog Controls]] for a description of parameters not described here.

Note that a lot of the listview's configuration is read from the <var>var2</var> table. You can configure the table using the <code>SET TABLE CONFIG</code> command.<pre>
[macro TestListView]
// create table data
#t := new table * /E * string:s1 string:s2
if '$#t[?]' != 'table' em -1 ; failed to create the table
$#t config s1 1 1 1 %s 0 '' '' 'heading1' * 0 1
$#t config s2 1 1 1 %s 0 '' '' '' * 0 1 // no heading specified. field name will be used
for #i := 0 to $#i < 100 step #i := int $#i + 1
    $#t * s1 's1str$#i' s2 's2str$#i'
end
// create the dialog item
#dlg := $(createmenu frame * ListView Text Dialog)
#map := CDlgMap $#dlg
$#dlg $($#map ci ok) button 0 0 '&OK' * 10 1
$#dlg $($#map ci cancel) button 0 10 '&Cancel' * 10 1
$#dlg $($#map ci) listview 1 0 '' #i 20 10 $#t /X /J /Header /Sort /Center
// update dialog controls
$#dlg * /Write
// begin the modal mode
domodaldialog begin $#dlg
$#dlg 1 focus
do forever // enter message loop
    // update the control
    $#dlg * /Write
    // get next dialog message
    domodaldialog loop $#dlg $($#map ci ok) $($#map ci cancel)
    // id and parameter only are returned
    readvar result #id #par
    // update the variables
    $#dlg * /Read
    // process messages
    if '$#id' == COMMAND then
        #ctl := set $($#map cn $#par)
        if '$#ctl' == 'ok' || '$#ctl' == 'cancel'then
            break // leave message loop
        end
    end
end
domodaldialog end // end modal mode
// clean up
delete $#t $#dlg $#map
exit
</pre>
A further example can be found in the example script file <code>editabletable.sts</code>.'''STARTEDIT'''

<code>SET <var>dialogItem</var> <var>listviewIndex</var> STARTEDIT <var>col</var> <var>row</var></code>

Sets the dialog focus to the specified cell and enters edit mode. If the user presses ESC, Return or Enter, the control leaves edit mode. <var>col</var> and <var>row</var> are zero-based indices addressing the field and entry. See the example script <code>editabletable.sts</code> for a complete example.

=== PROGRESS ===

[[File:dialog_control_progress.png]]

<code>SET <var>dialog index</var> PROGRESS <var>row col text var1 w h var2</var> [<var>fg bg font</var>][ /A|L|R ]</code>

The progress control can be used to display the progress of a process. It could also be used to simulate a level-meter or other value displays. The position (fill status) of a progress control is updated on each command specifying the option /Write. If a hash '<code>#</code>' is used in place of <var>var2</var>, the default range (0-100) is used. You can connect a value item to a progress control using the command <code>SET dialog index INPUT output</code>. If the user clicks the progress bar, the message <code>VALUE</code> is generated.

;<var>var1</var>

:The name of the position variable.

;<var>var2</var>

:The name of the range variable (<var>var2</var> = minimum maximum).

;<var>/Horizontal|Vertical</var>

:A horizontal or vertical progress bar.

;<var>/Smoothfill</var>

:Use smooth filling instead of blocked filling.

See [[User Guide/Waveform Plot and Segmentation/Control Dialog|Dialog Controls]] for a description of parameters not described here.

=== RADIOBUTTON ===

<code>SET <var>dialog index</var> RADIOBUTTON <var>row col text</var> [<var>var1</var>|<var>* w h * fg bg font</var>] [ /A|L|R ]</code>

The radio buttons are the only controls where one variable is bound to multiple controls. A new radio button group is started when a variable name <var>var1</var> is specified. For all other radio buttons of the group the argument <var>var1</var> must be set to '<code>*</code>'. The value of <var>var1</var> is set to <code>activeindex-groupstartindex,</code> where <code>groupstartindex</code> is the index of the first radio button of a group and <code>activeindex</code> is the index of the activated radio button of the same group. Only one button in the group can be activated at one time.

;<var>var1</var>

:The name of button index variable (only for the first button in the group).

See [[User Guide/Waveform Plot and Segmentation/Control Dialog|Dialog Controls]] for a description of parameters not described here.

Using radio buttons may lead to problems because the function searching for the first button in a group does not always work correctly. It only works if no other control (e.g. a groupbox or a static) is placed between the buttons of the group.

=== SLIDER ===

<code>SET <var>dialog index</var> SLIDER <var>row col text var1 width height var2</var> [<var>fg bg font</var>] [ /A|L|R ]</code>

Slider controls can be used to enter values by setting the slider position and/or the display values (similar to progress controls). Normally the slider position is defined by one value. If option /2 is specified the slider can be used to select a range. A scale can optional be displayed and configured (option /Scale and value <code>tickdistance</code> of <var>var2</var>). If a hash '<code>#</code>' is used in place of <var>var2</var>, the default range (0-1000) is used.

;<var>var1</var>

:The name of the position (<var>var1</var> <code>= pos</code>) or selection variable (<var>var1</var> <code>= min max</code>).

;<var>var2</var>

:The name of the range variable (<var>var2</var> <code>= minimum maximum tickdistance</code>).

;<var>/Horizontal|Vertical</var>

:Make the slider horizontal or vertical

;<var>/Scale=<var>pos</var></var>

:This option controls where the ticks are displayed. The value of <var>pos</var> can be set to <code>Above</code>|<code>Below</code>|<code>Left</code>|<code>Right</code>|<code>Both</code>|<code>None</code>.

;<var>/2</var>

:This option means that the slider has only two values, minimum and maximum. Otherwise a position is selected.

See [[User Guide/Waveform Plot and Segmentation/Control Dialog|Dialog Controls]] for a description of parameters not described here.

=== SPIN ===

[[File:dialog_control_spin.png]]

<code>SET <var>dialog index</var> SPIN <var>row col text var1 width height var2</var> [<var>fg bg font</var>] [ /A|L|R ]</code>

The spin control is a button with two arrows (horizontal: left/right, vertical:up|down) which increment (right|up) or decrement (left|down) the position variable in steps of <var>stepwidth</var>. If a hash '<code>#</code>' is used in place of <var>var2</var>, the default range (<code>0</code>-<code>100</code>) and <code>stepwidth</code> (<code>10</code>) are used.

;<var>var1</var>

:The name of the position variable.

;<var>var2</var>

:The name of the range variable (<var>var2</var> <code>= minimum maximum stepwidth</code>).

;<var>/Horizontal|Vertical</var>

:Horizontal or vertical spin button.

See [[User Guide/Waveform Plot and Segmentation/Control Dialog|Dialog Controls]] for a description of parameters not described here.

=== STATIC ===

[[File:dialog_control_static.png]]

<code>SET <var>dialog index</var> STATIC <var>row col text</var> [<var>*</var>|<var>var1 width height * fg bg font</var>] [ /L|R|C ]</code>

You can connect a value item to a static control using the command <code>SET dialog index INPUT output</code>.

;<var>text</var>

:The text to display in the static control.

;<var>var1</var>

:An optional variable to be used instead of <var>text</var>. If specified, the static's caption can be updated set to the content of <var>var1</var> by using the option /Write. Note that you can update the text even if you do not use a variable, by using the <code>SET dialog $#controlIndex * 'the new static text'</code> command.

;<var>/Left|Right|Center</var>

:Set the caption text alignment inside the static control.

See [[User Guide/Waveform Plot and Segmentation/Control Dialog|Dialog Controls]] for a description of parameters not described here.

You can display an image in a static control using the <code>SET dialog BITMAP</code> command.

=== TREEVIEW ===

[[File:dialog_control_treeview.png]]

<code>SET <var>dialog index</var> TREEVIEW <var>row col text var1 width height var2</var> [<var>fg bg</var>] [ /A|L|R ]</code>

;<var>var1</var>

:The name of table item for multiple selected elements (/X), or the name of shell variable for single selected item.

;<var>var2</var>

:The name of the file item containing the XML tree.

;<var>/X</var>

:Multiple items can be selected

;<var>/Expand</var>

:Expands the whole tree (without this option, the tree is only expanded up to the selected element)

;<var>/V</var>

:Enable the use of the XML attribute <code>Expand</code>. This attribute is set to <code>1</code> when a branch of the tree is expanded, and removed when the branch is collapsed. If the option /Expand is also used, the whole tree is expanded and all expanded branches have the <code>Expand</code> attribute set to <code>1</code>.

With commands containing the option /Read, the selection status is copied to the tag flags of the table entries, but the entry content remains unchanged. Dialog commands with the option /Write writes table data and selection status to the control. Table entries are displayed in show format (see <code>SET TABLE</code>).

See [[User Guide/Waveform Plot and Segmentation/Control Dialog|Dialog Controls]] for a description of parameters not described here.