ONLINE HELP
 WINDEVWEBDEV AND WINDEV MOBILE

Help / WLanguage / WLanguage properties / Properties associated with windows, pages and controls
  • Differences between the Name and Alias properties
WINDEV
WindowsLinuxJavaReports and QueriesUser code (UMC)
WEBDEV
WindowsLinuxPHPWEBDEV - Browser code
WINDEV Mobile
AndroidAndroid Widget iPhone/iPadIOS WidgetApple WatchMac Catalyst
Others
Stored procedures
Caution: In WEBDEV, the Alias property works in a different way than in WINDEV and WINDEV Mobile.
WINDEVWINDEV 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).
  • WINDEV the alias of a pane in a Dynamic Tab control.
WEBDEV - Server codeWEBDEV - Browser codePHP 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
WINDEVAndroidAndroid Widget IOS WidgetJava
// 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
WEBDEV - Server codeWEBDEV - Browser codePHPAjax
// Retrieve the value of a control passed as parameter
ValueEdit1 is string = PageParameter(EDT_Edit1.Alias)
Syntax
WINDEVAndroidAndroid Widget iPhone/iPadIOS WidgetJava

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.
WINDEVAndroidAndroid Widget iPhone/iPadIOS WidgetJava

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.
WINDEV

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>]
WINDEV

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.
WEBDEV - Server codeWEBDEV - Browser codePHPAjax

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
WEBDEV - Server codePHPAjax

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.
Minimum version required
  • Version 9
This page is also available for…
Comments
Click [Add] to post a comment

Last update: 09/18/2024

Send a report | Local help