Alias (Property)

the alias of a window. To change the alias of a window, you can also use the WinChangeAlias function.
Reminder: An alias is used to differentiate between the same window opened several times (frequent in an MDI application).

The Alias property returns the internal HTML/JavaScript name of a control.
Indeed, WLanguage is more permissive than JavaScript regarding the names of controls and pages: use of special characters, possibility to have two controls with the same name in the same page, ...
Therefore, the controls and the pages are renamed in the HTML pages. Furthermore, this name can be compressed.
Alias enables you to find out the name used in the HTML page.

Versions 15 and later

This property is now available for Android applications.

New in version 15

This property is now available for Android applications.

Versions 18 and later

This property is now available in Windows Store Apps mode.

This property is now available in Android Widget mode.

New in version 18

This property is now available in Windows Store Apps mode.

This property is now available in Android Widget mode.

This property is now available in Windows Store Apps mode.

This property is now available in Android Widget mode.

Versions 21 and later

This property is now available in Universal Windows 10 App mode.

This property is now available for iPhone/iPad applications.

New in version 21

This property is now available in Universal Windows 10 App mode.

This property is now available for iPhone/iPad applications.

This property is now available in Universal Windows 10 App mode.

This property is now available for iPhone/iPad applications.

Example

// Open a new child window
OpenChild(WIN_Child, sFileName)
{sFileName}..X = 10
// {sFileName} = alias of the window

// -- Opening code of WIN_Child
PROCEDURE WIN_Child(sFileName)
MySelf.Alias = sFileName
// Define the alias
// Changes the title of the window that was just opened
{sFileName}..Title = "File = " + {sFileName}..Alias

// Retrieve the value of a control passed as parameter
ValueEdit1 is string = PageParameter(EDT_Edit1.Alias)

Syntax

Finding out the alias of a window Hide the details

<Current alias> = <Window>.Alias

<Current alias>: Character string

Alias of the window,
Empty string ("") if the specified window has no alias.

<Window>: Window name

Name of window used. This parameter can be equal to:
MySelf. For example, if the name of the alias of the current window is sought.
an indirection on the alias of the window. Indeed, the alias name will be known only at runtime. The name of the alias is unknown when the code is compiled.

Modifying the alias of a window Hide the details

<Window>.Alias = <New alias>

<Window>: Window name

Name of window used. This parameter can be equal to:
MySelf. For example, if the name of the alias of the current window is sought.
an indirection on the alias of the window. Indeed, the alias name will be known only at runtime. The name of the alias is unknown when the code is compiled.

<New alias>: Character string

New alias for the window.

Syntax

Finding out the internal HTML/JavaScript name of an element Hide the details

<Current alias> = <Element name>.Alias

<Current alias>: Character string

Name of the element used in the HTML or JavaScript code.

<Element name>: Character string (with or without quotes)

Name of control or page whose name is requested.

Remarks

Differences between the Name and Alias properties

The Name property returns the WLanguage name of the control, whereas Alias returns the HTML name of the control. To pass a control name as a parameter to a JavaScript procedure, use the Alias property.