Properties of the WINDOW Object

ACTIVE

Specifies whether the window responds to the user's keyboard and mouse actions. If not, any controls placed in the window will also be disabled.

Adelia type	BOOL.
Accessibility
Layout design mode	Read / Write.
Execution mode	Read / Write.
Associated constants	none.
Conditions for use	none.
Default value	"*TRUE".

ADJUSTMENT

Authorizes the graphical controls to be adjusted when the window is resized. The adjustment is performed when the resized window is bigger than its initial size (the size when the ADJUSTMENT property is activated).

This property cannot be used with the HOMOTHETY property.

Adelia type	NUM_BIN_2.
Accessibility
Layout design mode	Read/Write.
Execution mode	Read/Write.
Associated constants
_WIN_ADJUST_CUSTOMIZE	The adjustment is defined for each object.
_WIN_ADJUST_SPACE_OUT	The controls are spaced out over the window's entire surface. The spaces between the objects are increased. The adjustment can be specified for each graphical object.
_WIN_ADJUST_NONE	No adjustment is applied to the controls.
Conditions for use	The window must be resizable. Does not apply to main windows. The HOMOTHETY property's value must be *FALSE.
Default value	_WIN_ADJUST_NONE.

Click here to see how the adjustment works.

ALLOW_SIZE_MODIFICATION

Indicates if it is authorized to modify the values of the WIDTH and HEIGHT properties when the RESIZABILITY property equals *FALSE.

Adelia type	BOOL
Accessibility
Layout design mode	Read/Write.
Execution mode	Read/Write.
Associated constants	None
Conditions for use	None
Default value	*FALSE

Note : This property is not implemented by the Java or the Mobile generator.

BACKGROUND_COLOR

RGB color in which the object's background is displayed.

Adelia type	NUM_BIN_4.
Accessibility
Layout design mode	Read / Write.
Execution mode	Read / Write.
Associated constants
_WIN_COL_SYSTEM	"system" color.
_WIN_COL_BLACK	"black" color.
_WIN_COL_BLUE	"blue" color.
_WIN_COL_CYAN	"cyan" color.
_WIN_COL_GREEN	"green" color.
_WIN_COL_MAGENTA	"magenta" color.
_WIN_COL_RED	"red" color.
_WIN_COL_WHITE	"white" color.
_WIN_COL_YELLOW	"yellow" color.
_WIN_COL_DARKBLUE	"dark blue" color.
_WIN_COL_DARKCYAN	"dark cyan" color.
_WIN_COL_DARKGREEN	"dark green" color.
_WIN_COL_PURPLE	"purple" color.
_WIN_COL_DARKRED	"dark red" color.
_WIN_COL_DARKYELLOW	"dark yellow" color.
_WIN_COL_GREY	"grey" color.
_WIN_COL_DARKGREY	"dark grey" color.
Conditions for use	none.
Default value	"_WIN_COL_SYSTEM".

BOTTOM_MARGIN

Defines the size in pixels of the space between the inner edge of the bottom of the window and the tab's lower edge.

Adelia type	NUM_BIN_4.
Accessibility
Layout design mode	Read / Write.
Execution mode	Read / Write.
Associated constants	none.
Conditions for use	the window must be of the type "_WIN_WINDOW_TABS".
Default value	"0".

CURRENT_PAGE

Current page number. The first page has the number 1. With single-page windows, this property is always set to 1. With tab windows, the value of this property is the sequence number of the page when all the pages are visible.

Adelia type	NUM_BIN_4.
Accessibility
Layout design mode	No.
Execution mode	Read / Write.
Associated constants	none.
Conditions for use	Does not apply to main windows.
Default value	"1".

Example:

* Assume the create/update an employee window

* is composed of three tabs. The third tab displays

* the employee's picture. The picture is stored in the IMAGES table.

* The table is read and the picture is displayed only after the

* ChangePage event of the window has been triggered and if

* you are positioned on the third tab.

IF EMPLOYEES_CUP_WIN:CURRENT_PAGE = 3

CHAIN_SQL IMAGES *COND(IID_CODE = :ZZ_ID_CODE)

IF *SQLCODE = *NORMAL

IMG_PICTURE:VISIBILITY = *TRUE

IMG_PICTURE:BITMAP = IIMAGE

IMG_PICTURE:IMAGE_LOCATION = _IMG_LOCATION_CENTER_IMAGE

ELSE

IMG_PICTURE:VISIBILITY = *TRUE

END

DISPLAY_MODE

Defines the window's display mode. The window can be minimized (icon), maximized (full screen) or shown in normal size.

If the display mode is set to "_WIN_NORMAL_DISPLAY" or "_WIN_MAXIMIZED_DISPLAY", the window becomes visible if it was not before.

Using this property will not alter the active window, unless this window is minimized via the property.

Modification of the property will only be taken into account if the window is being executed.

Adelia type	NUM_BIN_2.
Accessibility
Layout design mode	Read / Write.
Execution mode	Read / Write.
Associated constants
_WIN_NORMAL_DISPLAY	the window is neither minimized (icon) nor maximized (full screen),
_WIN_MINIMIZED_DISPLAY	the window is minimized (icon),
_WIN_MAXIMIZED_DISPLAY	the window is maximized (full screen).
Conditions for use	This property can only be used if the window has been executed. Therefore its value must be set in the Initialize event and not in the INITIALIZATION block.
Default value	"_WIN_NORMAL_DISPLAY".

Note: This property is not available in Mobile generation for Pocket PC and Smartphone platforms.

FLAT

Specifies whether the window's tabs are displayed as flat buttons or in the standard Windows style.

Adelia type	BOOL.
Accessibility
Layout design mode	Read/Write.
Execution mode	Read/Write.
Associated constants	none.
Conditions for use	none.
Default value	*FALSE.

Note: This property is available only in Mobile generation mode for Pocket PC and Smartphone platforms.

FONT

Character font used to display the text contained in tabs.

The string format contains the name, size, style and script, in that order. A semi-colon must be inserted between each element.

If you set a property's value, you MUST specify the name and size.

The different styles are specified using the following values:

- 1: Normal (no special style)
- 2: Strikethrough
- 16: Italics
- 256: Bold
- 4096: Underlined

The style value to be entered in the character string is therefore one of those above, or the sum of values different from 1.

The different script values are as follows:

0	Occidental (ANSI)
1	Default value (current value for the process)
2	Symbol
128	Japanese (Shift JIS)
129	Hangul Korean
130	Johab Korean
134	Simplified chinese GB2312
136	Traditional chinese (Big 5)
161	Greek
162	Turkish
163	Vietnamese
177	Hebrew
178	Arab
186	Baltic
204	Cyrillic
222	Thai
238	Central Europe
255	OEM/DOS

Adelia type	ALPHA(250).
Accessibility
Layout design mode	Read / Write.
Execution mode	Read / Write.
Associated constants	None.
Conditions for use	the window must be of the type "_WIN_WINDOW_TABS".
Default value	"MS Sans Serif;8;1;0".

Notes:

The size, style and script must be compatible with the chosen font. The Windows system font selection dialog box, accessible via the graphical object's Properties pages, provides a guide for selecting coherent values.

This property is not available in Java generation.

FORCE_REDRAW_OBJECTS

Forces the window's objects to redraw when this latter receives a system redraw instruction.

This property is necessary in order to avoid refresh problems when IMAGE, TEXT, CHECK BOX, RADIO BUTTON LIST or OUTPUT FIELD objects with the OVERLAP property set to true are laid out in the window.

For more information about managing overlapping of graphical objects, consult the working with object overlap section.

Adelia type	BOOL.
Accessibility
Layout design mode	Read / Write.
Execution mode	Read / Write.
Associated constants	None.
Conditions for use	None.
Default value	*FALSE.

Note: This property is not implemented in Java, Cloud and Mobile generation.

HEIGHT

Height value of the object.

Adelia type	NUM_BIN_4.
Accessibility
Layout design mode	Read / Write.
Execution mode	Read / Write.
Associated constants	none.
Conditions for use	none.
Default value	"300".

Example:

* On the resize event of the EMPLOYEES_WIN window

* the height and width of the EMPLOYEES_LST vary according to

* those of the window.

* List Height/Width = Window Height/Width

* minus the original difference between both values

EMPLOYEES_LST:HEIGHT = EMPLOYEES_WIN:HEIGHT - 116

EMPLOYEES_LST:WIDTH = EMPLOYEES_WIN:HEIGHT - 40

* the button's Y-axis varies according to the

* window's height variations.

* Button's Y-axis = window's height - original difference

* between Y-axis and height. The X-axis dos not vary.

BTN_OK:Y-axis = EMPLOYEES_WIN:HEIGHT - 58

BTN_OK:X-axis = EMPLOYEES_WIN:WIDTH - 195

HOMOTHETY

This property can only be activated if the window is resizable. When activated, any change in size made via the interface or by the program keeps the same proportions between the window dimensions. Additionally, all the objects are moved and resized so that they retain the same proportionality factor relative to the window dimensions.

Adelia type	BOOL.
Accessibility
Layout design mode	Read / Write.
Execution mode	Read / Write.
Associated constants	none.
Conditions for use	The window must be resizable. Does not apply to main windows.
Default value	"*FALSE".

Notes:

This property is not available in Java generation.

It is not available in Mobile generation for Pocket PC and Smartphone platforms.

LEFT_MARGIN

Defines the size in pixels of the space between the inner left-hand edge of the window and the tab's left-hand edge.

Adelia type	NUM_BIN_4.
Accessibility
Layout design mode	Read / Write.
Execution mode	Read / Write.
Associated constants	none.
Conditions for use	the window must be of the type "_WIN_WINDOW_TABS".
Default value	"0".

MAXIMIZING_BOX

Indicates the presence of a maximizing window button in the title bar.

Adelia type	BOOL.
Accessibility
Layout design mode	Read / Write.
Execution mode	Read / Write.
Associated constants	none.
Conditions for use	none.
Default value	"*TRUE".

Notes:

This property is in read-only mode in Java generation.

It is not available in Mobile generation for Pocket PC and Smartphone platforms.

MINIMIZING_BOX

Indicates the presence of a minimizing window button in the title bar.

Adelia type	BOOL.
Accessibility
Layout design mode	Read / Write.
Execution mode	Read / Write.
Associated constants	None.
Conditions for use	None.
Default value	"*TRUE".

Notes:

This property is in read-only mode in Java generation.

It is not available in Mobile generation for Pocket PC and Smartphone platforms.

MULTILINE

Specifies whether tabs are displayed on a single line or on several lines. If they are displayed on a single line, a spin button is displayed if necessary, to provide access to the hidden tabs. This property MUST be *TRUE when the TAB_POSITION property is set to _WIN_TAB_LEFT or _WIN_TAB_RIGHT.

Adelia type	BOOL.
Accessibility
Layout design mode	Read / Write.
Execution mode	Read / Write.
Associated constants	none.
Conditions for use	the window must be of the type "_WIN_WINDOW_TABS".
Default value	"*FALSE".

Note: This property is not available in Java generation.

NAME

Static name of the object.

Adelia type	ALPHA(128).
Accessibility
Layout design mode	Read/Write.
Execution mode	Read.
Associated constants	None.
Conditions for use	None.
Default value	Prefix of the basic object.

OK_BUTTON

Lets you show or hide the OK button in the title bar (in dialog mode) or in the navigation bar (page mode). This button closes the window.

Adelia type	BOOL.
Accessibility
Layout design mode	Read / Write.
Execution mode	Read / Write.
Associated constants	none.
Conditions for use	none.
Default value	"*TRUE".

Note: This property is available only in Mobile generation mode for Pocket PC and Windows CE Standard platforms.

RESIZABILITY

Enables window resizing.

Adelia type	BOOL.
Accessibility
Layout design mode	Read / Write.
Execution mode	Read.
Associated constants	none.
Conditions for use	none.
Default value	"*TRUE".

RIGHT_MARGIN

Defines the size in pixels of the space between the inner right-hand edge of the window and the tab's right-hand edge.

Adelia type	NUM_BIN_4.
Accessibility
Layout design mode	Read/Write.
Execution mode	Read/Write.
Associated constants	None.
Conditions for use	The window must be of the type "_WIN_WINDOW_TABS".
Default value	0

SOFTWARE_INPUT_PANEL

Shows or hides the button that displays the software's input panel (for user input).

Adelia type	BOOL.
Accessibility
Layout design mode	Read / Write.
Execution mode	Read / Write.
Associated constants	None.
Conditions for use	None.
Default value	*TRUE

Note: This property is available only in Mobile generation mode for Pocket PC platforms.

SYSTEM_MENU

Indicates the presence of a System menu in the title bar.

Adelia type	BOOL.
Accessibility
Layout design mode	Read / Write.
Execution mode	Read / Write.
Associated constants	none.
Conditions for use	none.
Default value	"*TRUE".

Notes:

This property is in read-only mode in Java generation.

It is not available in Mobile generation for Smartphone platforms.

TAB_POSITION

Used with tabbed windows to specify the position of the tabs on the page.

If the tabs are placed on the right or left of the page, the MULTILINE property MUST be set to *TRUE.

Adelia type	NUM_BIN_4.
Accessibility
Layout design mode	Read / Write.
Execution mode	Read / Write.
Associated constants
_WIN_TAB_TOP	Tabs are held at the top of the page.
_WIN_TAB_BOTTOM	Tabs are held at the bottom of the page.
_WIN_TAB_LEFT	Tabs are held at the left of the page.
_WIN_TAB_RIGHT	Tabs are held at the right of the page.
Conditions for use	the window must be of the type "_WIN_WINDOW_TABS".
Default value	"_WIN_TAB_TOP".

Note: This property is not available in Java generation.

TITLE

Text displayed in the window's title bar.

Adelia type	ALPHA(250).
Accessibility
Layout design mode	Read / Write.
Execution mode	Read / Write.
Associated constants	none.
Conditions for use	none.
Default value	" ".

Example:

* In the INITIALIZATION module of an employee

* create or update window.

IF EPROC_CODE = 'MO'

ZZ_ID_CODE:ACTIVE = *FALSE

EMP_CUP_WIN:TITLE = EMP_CUP_WIN:TITLE /// _MODIFY

BTN_VALID:TEXT = _MODIFY

ELSE

EMP_CUP_WIN:TITLE = EMP_CUP_WIN:TITLE /// _CREATE

ZZ_ID_CODE:ACTIVE = *TRUE

BTN_VALID:TEXT = _CREATE

END

*

TITLE_BAR

Indicates the presence of a title bar in the window.

Adelia type	BOOL.
Accessibility
Layout design mode	Read / Write.
Execution mode	Read / Write.
Associated constants	none.
Conditions for use	none.
Default value	"*TRUE".

Notes:

This property is in read-only mode in Java generation.

It is not available in Mobile generation for Smartphone platforms.

TOP_MARGIN

Defines the size in pixels of the space between the top edge of the area in the window that can contain objects and the tab's top edge.

Adelia type	NUM_BIN_4.
Accessibility
Layout design mode	Read / Write.
Execution mode	Read / Write.
Associated constants	none.
Conditions for use	the window must be of the type "_WIN_WINDOW_TABS".
Default value	"0".

VISIBILITY

Visibility of the object.

Adelia type	BOOL.
Accessibility
Layout design mode	Read / Write.
Execution mode	Read / Write.
Associated constants	none.
Conditions for use	none.
Default value	"*TRUE".

WIDTH

Width value of the object.

Adelia type	NUM_BIN_4.
Accessibility
Layout design mode	Read / Write.
Execution mode	Read / Write.
Associated constants	none.
Conditions for use	none.
Default value	"400".

WINDOW_CLASS

Defines the window's class.

Adelia type	NUM_BIN_2.
Accessibility
Layout design mode	Read / Write.
Execution mode	Read.
Associated constants
_WIN_DIALOG_CLASS	Window corresponding to the notion of Windows dialog box, and to the windows defined in Adelia versions earlier than V8.3.
_WIN_MAIN_CLASS	Window that is an application's main window. Main windows have a client area in which truncated child windows are displayed. They can have a status bar and tool bars.
_WIN_CHILD_CLASS	Child window of a main window. When active, the child window's menu is displayed instead of the main window's menu.
_WIN_CE_DIALOG_CLASS	Window representing a Windows CE dialog box.
_WIN_CE_FULL_SCREEN_CLASS	Window representing a full-screen Windows CE (Pocket PC and Smartphone) dialog box.
Conditions for use	none.
Default value	"_WIN_DIALOG_CLASS".

WINDOWS_MOBILE_STYLE

Sets the display mode for the window's menu.

In Windows Mobile mode the menu can only contain two main options. (No restriction applies to submenus).

Adelia type	BOOL.
Accessibility
Layout design mode	Read/Write.
Execution mode	Read/Write.
Associated constants	none.
Conditions for use	none.
Default value	*FALSE.

Note: This property is available only in Mobile generation mode for Pocket PC platforms.

WINDOWS_TYPE

Defines the window type.

Adelia type	NUM_BIN_4.
Accessibility
Layout design mode	Read / Write.
Execution mode	Read.
Associated constants
_WIN_WINDOW_SIMPLE	window without tabs.
_WIN_WINDOW_TABS	window with tabs.
Conditions for use	none.
Default value	"_WIN_WINDOW_SIMPLE".

X_AXIS

X-axis value of the window's top left corner. With Child window class windows, the origin is the top left corner of the main window's client area; otherwise, the origin is the top left corner of the screen.

The reference point (origin) is the top left corner of the object.

Adelia type	NUM_BIN_4.
Accessibility
Layout design mode	Read / Write.
Execution mode	Read / Write.
Associated constants	none.
Conditions for use	none.
Default value	none.

Y_AXIS

Y-axis value of the window's top left corner. With Child window class windows, the origin is the top left corner of the main window's client area; otherwise, the origin is the top left corner of the screen.

The reference point (origin) is the top left corner of the object.

Adelia type	NUM_BIN_4.
Accessibility
Layout design mode	Read / Write.
Execution mode	Read / Write.
Associated constants	none.
Conditions for use	none.
Default value	none.