Name (Property)

ONLINE HELP
WINDEV, WEBDEV AND WINDEV MOBILE

Version:

Home | Sign in | English

Help

Font variable
Window alias
Name of a tab pane
Type of object
Name of a connection
Limits

WINDEV

WEBDEV

WINDEV Mobile

Others

See also

Name (Property)

In french: Nom

Not available with this kind of connection

..Name is used to find out:

the name of the font associated with a Font variable.
Remark: The name of the font 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.
..Name is used to find out the real name of a control generated in the page, which means the alias of the control. This property can only be used on the following types of controls: edit control, List Box, Combo Box, Check Box, Radio Button and Button.

..Name is used to modify the name of the font associated with a Font variable.

..Name can also be used to manage the name 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 by programming,
- view,
- query run beforehand by HExecuteQuery,
- item defined in the data model editor or by programming,
- link defined in the data model editor or by programming.
Define the name of the described element:
- when a file is described by programming,
- when an item is described by programming,
- when a link is described by programming,
- when a full-text index is described by programming.

When used on the MyChildWindow keyword, the ..Name property retrieves the name of the last child window closed in a mobile application.

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 17 and later

This property is now available for iPhone/iPad applications.

New in version 17

This property is now available for iPhone/iPad applications.

Versions 18 and later

This property is now available in Windows Store Apps mode.

This property is now available for reports in iPhone/iPad applications.

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 for reports in iPhone/iPad applications.

This property is now available in Android Widget mode.

This property is now available in Windows Store Apps mode.

This property is now available for reports in iPhone/iPad applications.

This property is now available in Android Widget mode.

Versions 20 and later

This property is now available for Table controls and table columns in Android and iPhone/iPad applications.

New in version 20

This property is now available for Table controls and table columns in Android and iPhone/iPad applications.

Remark: From version 19, HFSQL is the new name of HyperFileSQL.

Versions 21 and later

This property is now available in Apple Watch mode.

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

New in version 21

This property is now available in Apple Watch mode.

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

This property is now available in Apple Watch mode.

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

Example

// Define the characteristics of a Font variable
Font1 is Font
Font1..Name = "Arial"
Font1..Size = 14
Font1..Orientation = 45
// Apply the font to "MyControl"
MyControl..Font = Font1

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
PROCEDURE 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 (with or without quotes)

Name of element to use.

Modifying the name of specified element Hide the details

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

Name of dynamic object used:
file defined by programming via the File description type,
item defined by programming via the Item description type,
link defined by programming via the Link description type.
full-text index defined by programming via the FullTextIndex description type.
or
Name of the Font variable to use.

<New name>: Character string

New name for the specified element

Remarks

Font variable

A font can be created from a Font variable.

To define the font characteristics, use:

FontCreate;
..Charset, ..Orientation, ..StrikeOut, ..Condensed, ..Color, ..Extended, ..Bold, ..Italic, ..Large, ..Underline and ..Size.

This font can be used:

To write text in drawings (dFont).
To write in charts (grLabelFont , grLegendFont , grTitleFont and grAxisTitleFont).
To print (iFont).
In the controls of a window (..Font property of controls in a window).
In the controls of a report (..Font property of controls in a report).

Window alias

The same window (child or sibling window) can be opened several times. To differentiate and identify the opened windows, an alias is assigned to each window.

To define an alias, use OpenSister or OpenChild. This alias is used to identify windows with functions that take a window name as a parameter (CurrentTitle, NextTitle, ReturnToCapture, etc.) or to handle a control in a given window.

To find out the alias of a window, use CurrentWin, PreviousWin or the ..Alias property.

If no alias is specified when the window is opened, an alias is automatically assigned to the window by WINDEV.

Name of a tab pane

..Name returns the name of the tab pane. For example: Tab[2] for the second tab pane.

Type of object

..Name returns an empty string ("") for:

the rows found in the Table, List Box, ListView or Combo Box controls,
the cells in Table controls.

Name of a connection

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, ..Name is used to find out the name of the connection defined by the HFSQL engine.

Versions 18 and later

Finding out the name of the last child window that was closed
In the mobile applications, the windows are opened by OpenMobileWindow (or OpenChild) instead of Open.

You can find out the name of the last child window that was closed in the "Closing of a child window" event of the window that opened the child window (the one that called OpenMobileWindow or OpenChild).

To do so, use ..Name on the MyChildWindow keyword:

// Close a child window
NameChildWindow = MyChildWindow..Name

Remark: ..ReturnedValue is used to find out the value returned by the child window when it is closed.

New in version 18

Finding out the name of the last child window that was closed
In the mobile applications, the windows are opened by OpenMobileWindow (or OpenChild) instead of Open.

To do so, use ..Name on the MyChildWindow keyword:

// Close a child window
NameChildWindow = MyChildWindow..Name

Remark: ..ReturnedValue is used to find out the value returned by the child window when it is closed.

Finding out the name of the last child window that was closed
In the mobile applications, the windows are opened by OpenMobileWindow (or OpenChild) instead of Open.

To do so, use ..Name on the MyChildWindow keyword:

// Close a child window
NameChildWindow = MyChildWindow..Name

Remark: ..ReturnedValue is used to find out the value returned by the child window when it is closed.

Limits

..Name cannot be used on:

an option in a Radio Button or Check Box control,
an element in a TreeView control.

..Name only applies to the following controls:

Edit control,
List Box,
Combo Box,
Check Box,
Radio Button,
Button,
Versions 23 and later
Group of controls.
New in version 23
Group of controls.
Group of controls.

..Name only applies to the following elements:

Button.
Static control.
Edit control.
Image.
Check Box.
Radio Button.
List Box.
Combo Box.
TreeView.
Tab.
Window.
Table.
Table column.
Supercontrol.

..Name only applies to the following elements:

Button control.
Static control.
Image control.
Window.