Adams Basic Package > Adams View > View Command Language > interface > interface window create

interface window create

Allows creation of a window. Windows and dialog boxes look similar, although they are quite different. Windows usually stay on the screen for some time as you work in them, while dialog boxes come and go as you need to enter data or access controls. Windows can contain toolbars and menu bars. Both windows and dialog boxes contain other interface objects such as buttons, labels, and so on.

Format:

 
interface window create
window_name =
new_GI_window
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
title =
String
icon_label =
String
start_commands =
String
finish_commands =
String
decorate =
yes/no
resizable =
yes/no
width_minimum =
real
width_maximum =
real
height_minimum =
real
height_maximum =
real
grab_all_input =
yes/no

Example:

 
interface window create &
window_name =
my_window &
height =
1.0 &
width =
2.0 &
enabled =
yes &
help_text =
"My first window" &
width_minimum =
250 &
width_maximum =
500 &
title =
"My window"
This will create a window having the title “My Window” with height =1.0[Half of the Adams View window) and width=2.0(Same Width as Adams View window). The minimum width beyond which the user will not be able to resize would be 250 and the maximum width would be 500. Since there is no height minimum and maximum specified, the user can resize the window created to any size.

Description:

 
Parameter
Value Type
Description
window_name
String
Specify the name of the new window created.
enabled
Yes/no
Specify whether the window created will be enabled or not.
help_text
String
Specify the string that should be displayed on the Adams View status bar when the mouse cursor is over the window created.
documentation_text
String
Specify the documentation text associated with this window.
units
Relative/Pixel
Specify whether the units used for the window measurements will be in pixels or relative.
horiz_resizing
ATTACH_LEFT/
ATTACH_RIGHT
/SCALE_CENTER/
EXPAND/
SCALE_ALL
Specify where the horizontal resizing should occur from.
vert_resizing
ATTACH_TOP/
ATTACH_BOTTOM/
SCALE_CENTER/
EXPAND/
SCALE_ALL
Specify where the vertical resizing should occur from.
location
Real
The real number should be greater than or equal to zero.
height,
Real
Specify a height for the info window. The value should be a real number between 0.0 and 2.0, where 2.0 represents the height of the Adams View window. Therefore, a value of 1.0 will set the info window to be one half as high as the Adams View window.
Width
Real
Specify a width for the info window. The value should be a real number between 0.0 and 2.0, where 2.0 represents the width of the Adams View window. Therefore, a value of 1.0 will set the info window to be one half as wide as the Adams View window.
title
String
This parameter allows the specification of the window title.
icon_label
String
Specify the label for the icon.
start_commands
String
Specify the commands to be executed at the start of the window creation.
finish_commands
String
Specify the commands to be executed at the end of the window creation.
Decorate
Yes/No
 
resizable
Yes/No
Specify whether this window can be resizable or not.
width_minimum
Real
Specify the minimum width beyond which the window should not be allowed to resize.
width_maximum
Real
Specify the maximum width beyond which the window should not be allowed to resize
height_minimum
Real
Specify the minimum height beyond which the window should not be allowed to resize
height_maximum
Real
Specify the maximum height beyond which the window should not be allowed to resize
grab_all_input
Yes/No
Default value will be No.

Extended Definition:

1. The title is a "quoted" character string that will be displayed at the top of the window. The title will be scaled and centered automatically.
Titles need not be unique.A title may be arbitrarily long and a combination of letters of the alphabet and numbers may be used.