ONLINE HELP
 WINDEVWEBDEV AND WINDEV MOBILE

Help / WLanguage / WLanguage properties / Various properties
  • Object type
  • Connection name
  • Limitations
WINDEV
WindowsLinuxUniversal Windows 10 AppJavaReports and QueriesUser code (UMC)
WEBDEV
WindowsLinuxPHPWEBDEV - Browser code
WINDEV Mobile
AndroidAndroid Widget iPhone/iPadIOS WidgetApple WatchMac CatalystUniversal Windows 10 App
Others
Stored procedures
The Name property is used to get:
  • the name of the font associated with a variable of type Font.
    Remark: The font name must correspond to one of the fonts installed on the current computer.
  • the name of a control, report or report block.
  • the name of a control, group of controls or window.
  • the name of a control, group of controls or page.
    WEBDEV - Browser code The Name property is used to get the real name of a control generated in the page, i.e. the control alias. This property can only be used on the following types of controls: edit control, List Box, Combo Box, Check Box, Radio Button and Button.
The Name property is used to change the name of the font associated with a Font variable.
The Name property can also be used to handle the names of different HFSQL objects. You can:
  • Find out the name of a connection.
  • Find out the name of an object handled by indirection:
    • data file defined in the data model editor or programmatically,
    • view,
    • query previously executed with HExecuteQuery,
    • item defined in the data model editor or through programming,
    • link defined in the data model editor or through programming.
  • Define the name of the described element:
    • when a file is described through programming,
    • when an item is described through programming,
    • when a link is described through programming,
    • when a full-text index is described through programming.
Example
WEBDEV - Server codeAjax
// Define the characteristics of a Font variable
Font1 is Font
Font1.Name = "Arial"
Font1.Color = LightYellow
Font1.Size = 14
Font1.SizeUnit = unitPoint
Font1.Orientation = 45
// Apply the font to "MyControl"
MyControl.Font = Font1
WEBDEV - Server codeAjaxHFSQL ClassicHFSQL Client/ServerHyper File 5.5
AnItem1 is Item Description
...
// Declare the item 1
AnItem1.Name = "ITM1"
AnItem1.Type = hItemText
AnItem1.Size = 20
HDescribeItem(AFile, AnItem1)
...
HDescribeFile(AFile)
HCréation(Temp_File)
// Procedure to which a control name is passed as parameter
PROCÉDURE MakeVisible(Control)
// Name of current control
IF {Control}..Name = "CustomerName" THEN
{Control}..Visible = True
END
Syntax

Finding out the name of specified element Hide the details

<Result> = <Element used>.Name
<Result>: Character string
Name of specified element.
<Element used>: Character string
Name of the element to be used.
WEBDEV - Server codeAjaxHFSQL ClassicHFSQL Client/Server

Modifying the name of specified element Hide the details

<Element used>.Name = <New name>
<Element used>: Character string
Name of the dynamic object used:
or
Name of the Font variable to be used.
<New name>: Character string
New name for the specified element
Remarks
WEBDEV - Server codeAjax A font can be created from a Font variable.
To define the font characteristics, use:
This font can be used:
WEBDEV - Server codePHPAjax

Object type

The Name property returns an empty string ("") for:
  • rows in the Table, List Box, ListView or Combo Box controls,
  • cells in Table controls.
WEBDEV - Server codeAjaxHFSQL Client/ServerOLE DBNative Connectors (Native Accesses)

Connection name

A connection can be created by a Connection variable. The name of the connection corresponds to the name of the variable.
If a connection with the same name already exists (in the analysis or described beforehand), the name of the connection is defined by the HFSQL engine that adds a suffix (a number) to the name of the variable.
In this case, the Name property returns the name of the connection defined by the HFSQL engine.

Limitations

WEBDEV - Server code The Name property cannot be used on:
  • an option in a Radio Button or Check Box control,
  • an element in a TreeView control.
WEBDEV - Browser code The Name property can only be used in the following controls:
  • Edit control,
  • List Box control,
  • Combo Box control,
  • Check Box control,
  • Radio Button control,
  • Button control,
  • Group of controls.
Minimum version required
  • Version 9
This page is also available for…
Comments
Click [Add] to post a comment

Last update: 02/29/2024

Send a report | Local help