<<

Contents

Search

>>

 

SPLIT_WINDOW

 

 

Function

 

 

Syntax:

SPLIT_WINDOW(<Handle>, <Type>, <Size>, <Red>, <Green>, <Blue> [,<Divider Size>, <Display Immediately>  [,<Red-2>, <Green-2>, <Blue-2>, <Direction>]])

 

<Handle>

= <NUM-EXPRESSION>

<Type>

= <NUM-EXPRESSION>

<Size>

= <NUM-EXPRESSION>

<Red>

= <NUM-EXPRESSION>

<Green>

= <NUM-EXPRESSION>

<Blue>

= <NUM-EXPRESSION>

<Divider Size>

= <NUM-EXPRESSION>

<Display Immediately>

= <NUM-EXPRESSION>

<Red-2>

= <NUM-EXPRESSION>

<Green-2>

= <NUM-EXPRESSION>

<Blue-2>

= <NUM-EXPRESSION>

<Direction>

= <NUM-EXPRESSION>

 

 

Meaning:

Creates a split window.

 

<Handle> defines the window to be split:

 

<Handle>

Meaning

0

The main window is split. If the main window has already been split, the split window that contains the original content of the main window is split again.

1000

The main window or the upper split window of the main window is split. If the main window is not in a split window, <Handle> = 1000 is identical with  <Handle> = 0. If the main window has already been split, the upper split window of the main window is split and not the split window that contains the main window, like with <Handle> = 0.

> 0 and < 1000

The window of the window depth <Handle> is split. If the window has already been split, the split window that contains the original content of the window, is split again.

> 1000 and < 2000

The window of the window depth <Handle> - 1000 or the upper split window of this window is split. If the window is not in a split window, <Handle> is identical with <Handle> - 1000. If the main window has already been split, the upper split window of the window is split and not the split window that contains the window, like with <Handle> > 0 und < 1000.

> 50000

The split window of an earlier splitting that is identified by <Handle> is split again. Every new split window of a splitting can only be split once.

 

<Type> specifies how the window is split:

 

<Type>

Available window

New split window

1

left

right

2

right

left

3

top

bottom

otherwise

bottom

top

 

SPLIT_WINDOW returns the handle of the new split window. In the function SPLIT_WINDOW the handle of a split window can also be specified as <Handle>. Then this split window is split again.

 

Only the main window, mask windows and windows created by the instruction WINDOW can be split.

 

 With SET_SPLIT_WINDOW_HEADER a header line can be created in the new split window, which contains a button for closing the split window.

 

The new split window can be filled with the following NOWAIT functions:

 

WINDOWCALL

SELECT / SELECTA

TREEVIEW

TABCONTROL

 

WINDOWCALL implicitly works like NOWAIT, with the other functions the parameter NOWAIT must be specified. In addition, the handle <Split Handle> of a split window must be specified after the parameter <Exit Macro>.

 

If a new mask is started with WINDOWCALL in a split window, the restarted mask immediately turns into the current mask; when another function is started the current mask does not change. 

 

The parameters <Red>, <Green> and <Blue> define background color of the new split window. If one of the three values < 0, the new split window is transparent, that means the old background color shines through.

 

If the parameters <Red-2>, <Green-2>, <Blue-2>, <Direction> are specified, a background gradient from color <Red>, <Green>, <Blue> to color <Red-2>, <Green-2>, <Blue-2> is created.

 

If a split window is active, EBUS_SPLITHANDLE contains the handle of the split window.

 

SPLIT_WINDOW returns the following values:

 

>50000

<Handle> of the new split window

-1

The window <Handle> does not exist.

-2

The split window has already been split.

-3

The split window has already been split.

 

Parameter:

Handle

Specifies the window to be split.

Type

Specifies how the window is split.

Size

Must be between 0 and 100 and defines the size of the old window as percentage of the available space. The new split window has the size 100 - <Size> %.

Example: <Size> = 30

After the split the old window covers 30% and the new split window 70% of the available space.

If <Size> < 0, -<Size> specifies the size of the old window in pixel.

Red

Red value

Green

Green value

Blue

Blue value

Divider Size

Specifies the width of the divider in pixel (read SET_SPLIT_WINDOW_DIVIDERSIZE).

If this parameter is missing, the standard width is applied.

Display Immediately

When a divider is shifted this parameter specifies whether the window contents are displayed immediately or only at the and of the shift. If <Display Immediately> = 0, the contents are only displayed at the end of the shift, otherwise immediately. If this parameter is missing, this is equivalent to <Display Immediately> = 0.

Red-2

Red value

Green-2

Green value

Blue-2

Blue value

Direction

Defines the gradient direction:

1 = from left to right

2 = from top to bottom

3 = from top right to bottom left

4 = from center outwards

5 = from left to right centered

6 = from top to bottom centered

7 = from center circular outwards

8 = corners

else = from top left to bottom right

 

Sample:

/* Split main window with proportion 3:1

HANDLE% = SPLIT_WINDOW(0,1,75,-1,-1,-1)

IF HANDLE% < 0

THEN ... Error ...

ENDIF

/* Load Mask No. 45 into the split window

H% = WINDOWCALL(#45,PROG.EXIT.SPLIT.WINDOW,HANDLE%)

 

See also:

SET_SPLIT_WINDOW_HEADER

REMOVE_SPLIT_WINDOW_HEADER

REMOVE_SPLIT_WINDOW

GET_SPLIT_SIZE

GET_SPLIT_WINDOW_DIVIDER

SET_SPLIT_WINDOW_DIVIDER

GET_SPLIT_WINDOW_DIVIDERSIZE

SET_SPLIT_WINDOW_DIVIDERSIZE

GET_SPLIT_WINDOW_DIVIDER_PIXEL

SET_SPLIT_WINDOW_DIVIDER_ENABLED

EBUS_SPLITHANDLE

SPLIT_HEADER_TEXTCOLOR

SPLIT_HEADER_BACKGROUNDCOLOR

SPLIT_HEADER_BACKGROUNDGRADIENT

SPLIT_HEADER_FONT

SPLIT_HEADER_FONTNAME

SPLIT_HEADER_FONTHEIGHT

SPLIT_HEADER_IMAGE_MARGIN