Token (Variable type)

ONLINE HELP
WINDEV, WEBDEV AND WINDEV MOBILE

Version:

Home | Sign in | English

This content has been translated automatically. Click here to view the French version.

Help / WLanguage / WLanguage functions / Controls, pages and windows / Token functions

Properties specific to Token variables
Manipulating tokens
Functions that use the Token type

WINDEV

WEBDEV

WINDEV Mobile

Others

See also

Token (Variable type)

In french: Jeton

The Token type is used to define all the advanced characteristics of a token displayed in an edit control. You can define and change the characteristics of this token using different WLanguage properties.

Note: For more details on the declaration of this type of variable and the use of WLanguage properties, see Declaring a variable.

Example

// Ajout d'un jeton dans un champ de saisie
MonJeton is Token 
MonJeton.Caption = Client.Nom
MonJeton.Value = Client.IdClient
EditAddToken(SAI_Client, MonJeton)

// Modification de la couleur de fond d'un jeton
FOR EACH MonJeton OF SAI_Client.Jeton
	IF MonJeton.Value = Client.IdClient THEN
		MonJeton.BackgroundColor = LightRed
	END
END

Properties

Properties specific to Token variables

The following properties can be used to handle a token:

Property name	Type used	Effect

BackgroundColor	Color variable	Background color of the token.
Caption	Character string	Caption of the token as it will be displayed in the Edit control. If this property is not specified, the caption of the token will correspond to its stored value.
	Character string	HTML code of the token caption as it will be displayed in the Edit control. If this property is not specified, the caption specified with the Caption property is used.
Color	Color variable	Color of the token text.
New in version 2025 Extra	Variant	Allows you to store advanced information without affecting the execution of the application. You can store values of any type (array, etc.). It is also possible to add members to the Extra property. Example: MyVariable.Extra.Info1 = Value MyVariable.Extra[Info2] = Value2 MyVariable.Extra.Date = DateSys()
StoredValue	Character string	Stored value of the token. Stores any type of value.
Tooltip	Character string	Tooltip displayed when hovering over the token.
Value	Character string	Token value.

Remarks

Manipulating tokens

To manipulate the tokens of an Edit control, it is possible to use:
- the token functions.
- the Token property of the Edit control that returns an editable list containing all the tokens displayed in the control.
To reset the content of a Token variable, use VariableReset.

Functions that use the Token type

The following functions use Token variables:


EditAddToken	Adds a token to a "Text token" Edit control.
EditInsertToken	Inserts a token into a "Text token" Edit control.