Adams Basic Package > Adams View > View Command Language > interface > interface slider modify

interface slider modify

Allows modifying of an existing slider on the dialog box.
The slider is an element on the dialog box, specifying a variable parameter, the dragGIng of the slider bar, will vary the parameter value between minimum and maximum depending on the current position of the slider.

Format:

 
interface slider modify
slider_name =
An Existing GI_slider
new_slider_name =
A New GI_slider
enabled =
Boolean
help_text =
String
documentation_text =
String
units =
Int_units
horiz_resizing =
Int_h_resize
vert_resizing =
Int_v_resize
location =
Real
height =
Real
width =
Real
commands =
String
value =
Integer
minimum =
Integer
maximum =
Integer
live_drag =
Boolean
show_value =
Boolean

Example:

 
interface slider modify &
slider_name =
.gui.dbox.sldr &
new_slider_name =
.gui.dbox.sldr1 &
enabled =
yes &
help_text =
"help2text" &
documentation_text =
"doc2text" &
units =
relative &
horiz_resizing =
attach_left &
vert_resizing =
attach_top &
location =
0.2,0.2 &
height =
0.2 &
width =
0.6 &
commands =
"interface dialog display dialog=.gui.about_Adams" &
value =
0 &
minimum =
0 &
maximum =
1 &
live_drag =
yes &
show_value =
yes

Description:

 
Parameter
Value Type
Description
slider _name
An Existing GI_slider
Specifies the name of an existing slider
new_slider_name
 
Specifies a new name for the slider
enabled
Boolean
Activates the slider
help_text
String
Specifies the help text
documentation_text
String
Specifies the documentation text
units
Int_units
Specifies the slider size as pixel or relative to dialog box window
horiz_resizing
Int_h_resize
Specifies the attachment and scaling option for the slider
vert_resizing
Int_v_resize
Specifies the attachment and scaling option for the slider
location
Real
Specifies the location of the slider on the dialog box
height
Real
Specifies the height of the slider in terms of relative units or pixel
width
Real
Specifies the width of the slider field in terms of relative units or pixel
commands
String
Specifies the command to be executed while the slider is dragged
value
Integer
Specifies the default value of the command
minimum
Integer
Specifies the minimum value at the beGInning of slider
maximum
Integer
Specifies the maximum value at the end of slider
live_drag
Boolean
Specifies the live display of current value on the slider
show_value
Boolean
Specifies the default parameter for displaying the current slider value

Extended Definition:

1. The preliminary parameters of the slider like size, associated commands and range of values are set using this command. A new name can be specified for the slider by using parameter ‘new_slider_name’.
2. The pop-up help and documentation help can be specified in appropriate columns.
3. The size of the slider can be specified either in terms of number of pixels. Alternatively, the size can also be stated as relative to the dialog box window
4. The vertical and horizontal resizing options are used to adjust the placement of the slider menu on existing dialog box. For example, attach_left; attach_top options for Horiz_resizing and Vert_resizing will place the slider on the top left corner of the dialog box. The location can also be specified from the top left corner by adjusting the parameter ‘location’
5. The size of the slider window can be specified with respect to the dialog box window size. The value for parameter height and width should be a real number between 0.0 and 2.0, where 2.0 represents the height of the dialog window. Therefore, a value of 1.0 will set the slider field window to be one half as high as the dialog box window.
6. The parameter ‘command’ specifies the name of the command to be executed, when the slider is dragged. The parameters ‘minimum’ and ‘maximum’ shows the slider lower and upper limit values, the instantaneous or current value of which is displayed over the slider, if the parameter ‘show_value’ is set to ‘yes’. Similarly, if the command to be executed concurrently with the slider movement, when the slider is dragGIng, the parameter ‘live_drag’ needs to be set to ‘yes’.