AttachPointAdd (Function)

WINDEV, WEBDEV AND WINDEV MOBILE
ONLINE HELP

Version:

Home | Sign in | English

Help

WLanguage

WLanguage functions

Controls, pages and windows

Functions for managing controls

AttachPointAdd

Presentation

Example

Defining an attach point

Position of the attach point

ControlExecuteClosing

ControlExecuteModification

CoordinateEditorToScreen

CoordinateScreenToEditor

Functions for managing controls

Defining an attach point
Position of the attach point

WINDEV

WEBDEV

WINDEV Mobile

Others

See also

AttachPointAdd (Function)

In french: PointDAttacheAjoute

Defines an attach point for one of the two extremities of a Wire control.

Example

StartAttachPointID is int
EndAttachPointID is int

Link_wire is Control

Link_wire <- ControlCreate("Link", typWire)

Link_wire..StartControl = IMG_Start
Link_wire..EndControl = IMG_End

StartAttachPointID = AttachPointAdd(IMG_Start, 100, 25))
EndAttachPointID = AttachPointAdd(IMG_End, 0, 75))

Link_wire..AttachPointStart = StartAttachPointID
Link_wire..AttachPointEnd = EndAttachPointID

Syntax

Defining an attach point via its coordinates Hide the details

<Result> = AttachPointAdd(<Control Name> , <X> , <Y>)

<Result>: Integer

Identifier of the attach point. This identifier is used by ..AttachPointStart and ..AttachPointEnd.

<Control Name>: Character string (with or without quotes)

Name of the start or end control of the Wire control.

<X>: Integer

Horizontal position of the attach point in % (see the Notes). The value of this parameter must be included between 1 and 100.

<Y>: Integer

Vertical position of the attach point in % (see the Notes). The value of this parameter must be included between 1 and 100.

Defining an attach point via a Point variable Hide the details

<Result> = AttachPointAdd(<Control Name> , <Point>)

<Result>: Integer

Identifier of the attach point. This identifier is used by ..AttachPointStart and ..AttachPointEnd.

<Control Name>: Character string (with or without quotes)

Name of the start or end control of the Wire control.

<Point>: Point variable

Name of the Point variable corresponding to the attach point. The coordinates of the point are expressed in % (see the Notes).

Remarks

Defining an attach point

To define an attach point, you must know:

The control linked to the attach point. This control corresponds to the start or end point of the Wire control.
The position of the attach point on one of the control sides.

The attach point can correspond to the start or end point of the Wire control.

Position of the attach point

The position of the attach point is defined by 2 values representing in percentage the X and Y position (horizontal and vertical) in relation to the control.

For example:

if <X> is set to 0, the attach point starts from the left side of the control.
if <X> is set to 100, the attach point starts from the right side of the control.
if <Y> is set to 0, the attach point starts from the top side of the control.
if <Y> is set to 100, the attach point starts from the bottom side of the control.

Another example: To start the Wire control from the attach point found at the bottom and in the middle of the control:

<X> must be equal to 50,
<Y> must be equal to 100.

Component : wd240obj.dll