EditInsertToken (Function)

WINDEV, WEBDEV AND WINDEV MOBILE
ONLINE HELP

Version:

Home | Sign in | English

Help

WLanguage

WLanguage functions

Controls, pages and windows

Token management functions

See also

EditInsertToken (Function)

In french: SaisieInsèreJeton

Inserts a token into a "Text token" edit control.

Example

// Click [Insert the test robot]
EditInsertToken(EDT_Recipient, 1, "ROBOT", "robotmail@address.test.com")

// Syntax using the Token type
MyToken is Token
MyToken..DisplayedValue = "ROBOT"
MyToken..StoredValue = "robotmail@address.test.com"
EditInsertToken(EDT_Recipient, 1, MyToken)

Syntax

Inserting a token directly Hide the details

<Result> = EditInsertToken(<Edit control> , <Position> , <Value> [, <Caption>])

<Result>: Integer

Real subscript of the inserted token,
0 if an error occurred:
If the edit control is not a "Text token" edit control (..TokenEnabled is False).
If a duplicate has been detected and if ..TokenAllowDuplicate is set to False.

<Edit control>: Control name

Name of the "Text token" edit control.

<Position>: Integer

Token insertion subscript.
If <Position> is greater than the number of tokens in the control, the token is added at the end of the existing tokens (EditAddToken).
If <Position> is set to 0, the token is added at the beginning.
If <Position> is set to -1, <Result> is 0.

<Value>: Character string (with quotes)

Value of the token.

<Caption>: Optional character string (with quotes)

Caption of the token. If this value is not specified, it will correspond to the value of the token.

Inserting a token via the Token type Hide the details

<Result> = EditInsertToken(<Edit control> , <Position> , <Token>)

<Result>: Integer

Real subscript of the inserted token,
0 if an error occurred:
If the edit control is not a "Text token" edit control (..TokenEnabled is False).
If a duplicate has been detected and if ..TokenAllowDuplicate is False.

<Edit control>: Control name

Name of the "Text token" edit control.

<Position>: Integer

Token insertion subscript.
If <Position> is greater than the number of tokens in the control, the token is added at the end of the existing tokens (EditAddToken).
If <Position> is set to 0, the token is added at the beginning.
If <Position> is set to -1, <Result> is 0.

<Token>: Token variable

Name of the Token variable describing the token to add.

Remarks

To add a token at the cursor position, use EditAddToken.
The edit control ..StoredValue property returns the stored values for the tokens, separated by the characters <CR> (Carriage Return).

Related Examples:

Unit examples (WINDEV): The Text token edit control

[ + ] Using a "Text token" edit control.

Unit examples (WEBDEV): The text token edit control

[ + ] Using a "Text token" edit control.

Unit examples (WINDEV Mobile): The Text token edit control

[ + ] Using a "Text token" edit control.

Business / UI classification : UI Code

Component : wd250obj.dll