Alias (Property)

Caution: The operating mode of ..Alias differs according to the product used: the operating mode in WEBDEV differs from the operating mode in WINDEV and WINDEV Mobile.

..Alias is used to find out and modify:

the alias of a window. To modify the alias of a window, you also have the ability to use WinChangeAlias.
Reminder: An alias is used to differentiate between the same window opened several times (frequent in an MDI application).
Versions 20 and later
the alias of a pane in a dynamic Tab control.
New in version 20
the alias of a pane in a dynamic Tab control.
the alias of a pane in a dynamic Tab control.

..Alias 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 is used to find out the name used in the HTML page.

Versions 15 and later

This property is now available for the Android applications.

New in version 15

This property is now available for the 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 the iPhone/iPad applications.

New in version 21

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

This property is now available for the iPhone/iPad applications.

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

This property is now available for the 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 in parameter
ValueEdit1 is string = PageParameter(EDT_Edit1..Alias)

Syntax

Finding out the alias of a window Hide the details

<Current alias> = <Window name>..Alias

<Current alias>: Character string

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

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

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 at run time only. The name of the alias is unknown when the code is compiled.

Modifying the alias of a window Hide the details

<Window name>..Alias = <New alias>

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

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 at run time only. The name of the alias is unknown when the code is compiled.

<New alias>: Character string

New alias for the window.

Syntax

Versions 20 and later

Finding out the alias of the current Dynamic Tab control pane Hide the details

<Current alias> = <Tab pane name>..Alias

<Current alias>: Character string

Alias of the dynamic tab pane.

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

Name of the current Tab control pane identified by the following syntax:

<Tab control name>[<Tab control name>]

New in version 20

Finding out the alias of the current Dynamic Tab control pane Hide the details

<Current alias> = <Tab pane name>..Alias

<Current alias>: Character string

Alias of the dynamic tab pane.

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

Name of the current Tab control pane identified by the following syntax:

<Tab control name>[<Tab control name>]

Finding out the alias of the current Dynamic Tab control pane Hide the details

<Current alias> = <Tab pane name>..Alias

<Current alias>: Character string

Alias of the dynamic tab pane.

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

Name of the current Tab control pane identified by the following syntax:

<Tab control name>[<Tab control name>]

Versions 20 and later

Modifying the alias of the current Dynamic Tab control pane Hide the details

<Tab pane name>..Alias = <New alias>

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

Name of the current Tab control pane identified by the following syntax:

<Tab control name>[<Tab control name>]

<New alias>: Character string

New alias of the dynamic tab pane.

New in version 20

Modifying the alias of the current Dynamic Tab control pane Hide the details

<Tab pane name>..Alias = <New alias>

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

Name of the current Tab control pane identified by the following syntax:

<Tab control name>[<Tab control name>]

<New alias>: Character string

New alias of the dynamic tab pane.

Modifying the alias of the current Dynamic Tab control pane Hide the details

<Tab pane name>..Alias = <New alias>

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

Name of the current Tab control pane identified by the following syntax:

<Tab control name>[<Tab control name>]

<New alias>: Character string

New alias of the dynamic tab pane.

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 property and the ..Alias property

..Name returns the WLanguage name of the control while ..Alias returns the HTML name of the control. To pass a control name in parameter to a Javascript procedure, use ..Alias.