%ww - Window Style

Purpose

To change the style of a window.

Syntax

winio@('%ww[options]')

Description

By default, a format window that uses neither %ww nor %sy (Dialog Style) has a caption bar but does not have: a) system menu, b) a minimise box and c) a maximise box. Such a window has a double frame that is raised.

%ww is used to change the style a window. If %ww is used without any of its options, the resulting window has a caption bar that includes: a) system menu, b) a minimise box and c) a maximise box. Such a window has a single frame that is not raised.

The list of options given below includes options for changing the border of the window. This refers to the space that, by default, is provided by ClearWin+ to surround the text and controls within a window (as in %bd (Borders)). Do not confuse this border with the frame of the window that is determined by the Windows API style.

A window that uses %ww can be re-sized if a pivot (%pv (Pivot)) is also included.

options can be one or more of:


no_caption

Omit the caption from the window.

no_maxminbox

Omit the maximise and minimise boxes from the window.

no_maxbox

Omit the maximise box.

no_minbox

Omit the minimise box.

no_sysmenu

Omit the box at the top left which can be used to produce the system menu.

no_border

Omit the blank border which normally surrounds the window contents, but leave the frame itself. Using this format you can, for example, force a tool bar (textual or bit-mapped) to be placed immediately beneath the menu.

thin_border

Produces a half-size white border.

no_frame

Omit the window frame and the blank border which normally surrounds the window contents. This option is particularly useful with certain types of child window.

no_edge

This option is like no_frame except that it leaves the default border i.e. an empty space around the edge of the window.

naked

Equivalent to no_frame with no_border and no_caption.

volatile

The window closes when the focus is lost.

inactive

Disables the window.

invisible

Hides the window.

fixed_size

Prevents the user from resizing the window.

not_fixed_size

Allows the user to resize the window.
Provides an alternative to %pv which implies not_fixed_size.

topmost

Forces the window to stay on top, even if another application gets control. This is sometimes useful when it is necessary to execute another application without the user losing sight of the window of the main application.

maximise
(or maximize)

Displays the window as a maximised window.

minimise
(or minimize)

Displays the window as a icon.

super_maximise
(super_maximize)

Displays only the client area (requires an accelerator key attached to the Escape key that restores the normal window).

independent

Makes the window independent of other windows in the program that are already open. This can be used to create several windows which the user can move between at will and where there is no implied window hierarchy.

toolwindow

Prevents the window from appearing in the windows taskbar and hides it from the windows that appear when the user presses Alt+Tab.


Example

winio@('%ww[no_border, maximise]')

See also

%sy (Dialog Style)


 

 

 

Basket
Empty
 
Copyright © 1999-2024 Silverfrost Limited