Name (Property)

ONLINE HELP
WINDEV, WEBDEV AND WINDEV MOBILE

Version:

Home | Sign in | English

This content has been translated automatically. Click here to view the French version.

Help / WLanguage / WLanguage properties / Various properties

Object type
Connection name
Limitations

WINDEV

WEBDEV

WINDEV Mobile

Others

See also

Name (Property)

In french: Nom

Not available with this kind of connection

The Name property is used to get:

the name of the font associated with a variable of type Font.
Note: The font name must match one of the fonts installed on the current workstation.
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.
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 programmatically.
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

// Définir les caractéristiques d'une variable de type Police
Police1 is Font
Police1.Name = "Arial"
Police1.Color = LightYellow
Police1.Size = 14
Police1.SizeUnit = unitPoint
Police1.Orientation = 45
// Appliquer la police au champ "MonChamp"
MyControl.Police = Police1

UneRub1 is Item Description
...
// Déclaration de la rubrique 1
UneRub1.Name = "RUB1"
UneRub1.Type = hItemText
UneRub1.Size = 20
HDescribeItem(UnFichier, UneRub1)
...
HDescribeFile(UnFichier)
HCreation(Fic_temp)

// Procédure à laquelle le nom d'un champ est passé en paramètre
PROCEDURE RendreVisible(Champ)
// Nom du champ en cours
IF {Champ}..Name = "NomClient" THEN
	{Champ}..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.

Modifying the name of specified element Hide the details

<Element used>: Character string

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

<New name>: Character string

New name for the specified element

Remarks

A font can be created from a Font variable.

To define the font characteristics, use:

the FontCreate function.
the Charset, Orientation, StrikeOut, Color, Bold, Italic, CharacterSpacing, LineSpacing, Name, Underline, Size and SizeUnit properties.

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).
In the controls of a report (Font property).

Object type

The Name property returns an empty string ("") for:

lines in Table, List, List Box control or Combo fields,
cells in Table controls.

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

The Name property cannot be used on:

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

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.