<Dockable panel>.Attach (Function)

ONLINE HELP
WINDEV, WEBDEV AND WINDEV MOBILE

Version:

Home | Sign in | English

Help

WLanguage

WLanguage functions

Controls, pages and windows

Dockable Panel functions

Attach

Presentation

Example

See also

<Dockable panel>.Attach (Function)

In french: <Panneau dockable>.Attache

Attaches or changes the attach position of a Dockable Panel control.

Example

// Create a configuration with 2 panels at the bottom, one next to the other
DOPA_Left.Attach(dopaLeft)
DOPA_Right.Attach(dopaTop + dopaRight)

// Create a configuration with 2 panels at the bottom in the same area
DOPA_Details.Attach(dopaRight)
DOPA_Info.Attach(dopaRight)

Syntax

<Dockable Panel control>.Attach([<Reference Panel control>] [, <Position>])

<Dockable Panel control>: Control name

Name of the Dockable Panel control to use.

<Reference Panel control>: Optional control name

Name of the Dockable Panel control to be used as reference. If this parameter is specified:
the position set with the <Position> parameter will be relative to this control.
if the <Position> parameter is not specified, <Dockable Panel control> will be positioned in the same tab as <Reference Panel control>.

<Position>: Optional String constant (or combination of constants)

Describes the position where the Dockable Panel control should be attached:
dopaBottom Attaches the Dockable Panel control to the bottom.
dopaLeft Attaches the Dockable Panel control to the left.
dopaRight Attaches the Dockable Panel control to the right.
dopaTop Attaches the Dockable Panel control to the top.

The constants can be combined in pairs, where a constant gives the Left/Right position and another gives the Bottom/Top position.
If this parameter is not specified and the control is a Dockable Panel control, it is attached to its last known position.
If the position is already occupied, the Dockable Panel control is added to the area and a pane is automatically created and displayed.

Remarks

The position of the Dockable Panel control can be known using PanelPosition.
<Dockable panel>.Attach causes a non-fatal error if the position is invalid.

Business / UI classification: UI Code

Component: wd280obj.dll