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

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

// 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

AnItem1 is Item Description
...
// Declare the item 1
AnItem1.Name = "ITM1"
AnItem1.Type = hItemText
AnItem1.Size = 20
HDescribeItem(AFile, AnItem1)
...
HDescribeFile(AFile)
HCreation(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

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

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