Alias (Property)

ONLINE HELP
WINDEV, WEBDEV AND WINDEV MOBILE

Version:

Home | Sign in | English

Help / WLanguage / WLanguage properties / Properties associated with windows, pages and controls

Differences between the Name and Alias properties

WINDEV

WEBDEV

WINDEV Mobile

Others

See also

Alias (Property)

In french: Alias

Caution: In WEBDEV, the Alias property works in a different way than in WINDEV and WINDEV Mobile.

The Alias property is used to get or change:

the alias of a window. To change the alias of a window, you can also use WinChangeAlias.
Reminder: Aliases can be used to identify a window opened multiple times (common case in an MDI application).
the alias of a pane in a Dynamic Tab control.

The Alias property returns the internal HTML/JavaScript name of a control.
WLanguage is less restrictive with control and page names than JavaScript. This allows you to use special characters, have two controls with the same name in the same page, etc.
Controls and pages are renamed in HTML pages. These names can be compressed for optimization purposes.
The Alias property gets the name used in the HTML page.

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

Getting 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 the window used. This parameter can be equal to:
MySelf. If you want to get the alias of the current window, for example.
an indirection to the alias of the window. The alias will be known at runtime. The name of the alias is unknown when the code is compiled.

Changing the alias of a window Hide the details

<Window>.Alias = <New alias>

<Window>: Window name

Name of the window used. This parameter can be equal to:
MySelf. If you want to get the alias of the current window, for example.
an indirection to the alias of the window. The alias will be known at runtime. The name of the alias is unknown when the code is compiled.

<New alias>: Character string

New window alias.

Getting 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

Name of the current Tab control pane identified by the following syntax:
<Tab control>[<Tab control>]

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

<Tab pane>.Alias = <New alias>

<Tab pane>: Character string

Name of the current Tab control pane identified by the following syntax:
<Tab control>[<Tab control>]

<New alias>: Character string

New alias of the dynamic tab pane.

Getting 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

Name of the desired control or page.

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.