Name (Property)

ONLINE HELP
WINDEV, WEBDEV AND WINDEV MOBILE

Version:

Home | Sign in | English

Help

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

Font variable
Alias of a window
Name of a tab pane
Object type
Name of a connection
Limits

WINDEV

WEBDEV

WINDEV Mobile

Others

See also

Name (Property)

In french: Nom

Not available with this kind of connection

The Property Name allows you to know:

the name of the font associated with a Font variable.
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.

The Property Name allows you to change the name of the font associated with an Variable of type Font.

The Property Name also allows you to manage the name of the 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 previously executed with function 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.

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

Example

// Définir les caractéristiques d'une variable de type Police
Police1 is Font
Police1.Name = "Arial"
Police1.Size = 14
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)
HCréation(Fic_temp)

// Procédure à laquelle le nom d'un champ est passé en paramètre
PROCÉDURE 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 (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;
Alphabet, Angle, Barred, Condensed, Color, Extended, Bold, Italics, Large, Underlined 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 fields of a window (Property Font of the fields of a window).
In the fields of an report (Property Font of the fields of an report).

Alias of a window

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 know the alias of a window, use the CurrentWin, PreviousWin or Property Alias functions.

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

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

Object type

The Property 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, the Property Name allows to know the name of the connection defined by the HFSQL engine.

Limits

The Name property applies only to the following elements:

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