AddLink (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

ControlExecuteClosing

ControlExecuteModification

CoordinateEditorToScreen

CoordinateScreenToEditor

Functions for managing controls

WINDEV

WEBDEV

WINDEV Mobile

Others

See also

AddLink (Function)

In french: AjouteLien

Adds a link onto a text section in an edit control. The clicks on this link are processed by programming.

Example

// == Global declarations of the window ==
aaLinkTarget is array of strings

// == Click on the Button control "Add a note" ==
LinkRank is int
Destination is string

// Asks for a note to associate with the link
IF Input("Enter a note associated with this link:", Destination) = 1 THEN

// Stores the note in an array
LinkRank = Add(aaLinkTarget, Destination)

// Adds the link into the edit control
AddLink(EDT_Edit, EDT_Edit..Cursor, ...
EDT_Edit..CursorEnd, ClickOnLink, LinkRank)
END

// == ClickOnLink procedure ==
PROCEDURE ClickOnLink(LinkRank is int)
InfoBuild("The note associated with the %1 link is: %2", LinkRank, ...
aaLinkTarget[LinkRank])

Syntax

AddLink(<Edit control> , <Start position of link> , <End position of link> , <WLanguage procedure> [, <Procedure parameter>])

<Edit control>: Control name

Name of edit control to use.

<Start position of link>: Integer

Position of the first character of the link. The subscript of the first character found in the control is set to 1. The function has no effect if the start position of the link is greater than the size of the text.

<End position of link>: Integer

Position of the first character after the link. The function has no effect if the end position of the link is less than the start position of the link.

<WLanguage procedure>: Procedure name

Name of the WLanguage procedure called during a click on the link.

<Procedure parameter>: Optional variant

Parameter that will be passed to the procedure during a click on the link. If this parameter is not specified, the procedure will receive no parameter.

Remarks

AddLink can be used on the text and RTF edit controls (but not on the HTML edit controls).
To delete a link, all you have to do is reassign the corresponding text section.
The links added by AddLink are not kept:
- during a copy into the clipboard.
- during a call to ScreenToFile. In this case, only the HTML is copied into the HFSQL buffer.
Versions 22 and later
The color of the links can be configured by LinkColor.
New in version 22
The color of the links can be configured by LinkColor.
The color of the links can be configured by LinkColor.

Component : wd240obj.dll