Size (Property)

the size (in picas) of a Font variable.
Remark: the font name must correspond to one of the fonts installed on the current computer. The font size is set to 12 by default.
the maximum number of characters found in:
- a window control (edit control, table column or editable combo box)
- a page control (edit control)
- a Static control in a report.
  Remark: The maximum number of characters found in a control is defined in the "General" tab of the control description.
the maximum size of a text item (character string, text memo, character) defined in the data model editor or by programming.
the maximum size of a Time item defined in the data model editor or by programming.

This property can also be used to find out:

the number of columns in a Table control.
Versions 16 and later
the maximum number of characters in a Captcha control.
New in version 16
the maximum number of characters in a Captcha control.
the maximum number of characters in a Captcha control.

Versions 16 and later

This property is available in PHP only for Captcha controls.

New in version 16

This property is available in PHP only for Captcha controls.

This property is available in PHP only for Captcha controls.

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 report controls in iPhone/iPad applications.

New in version 18

This property is now available in Windows Store Apps mode.

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

This property is now available in Windows Store Apps mode.

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

Versions 20 and later

This property is now available for table columns in Android applications.

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

New in version 20

This property is now available for table columns in Android applications.

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

This property is now available for table columns in Android applications.

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

Versions 21 and later

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

New in version 21

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

Versions 22 and later

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

New in version 22

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

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

Example

See additional examples

// Define the maximum number of characters found in the "DelivAddress" item
AddressLiv.address Size = 50
...
// Define the maximum number of characters found in the "DelivTime" item
TimeLiv Size = 6 // HHMMSS format
...
// Validate the data file description
HDescribeFile(Customer)

// Modify the maximum number of characters found in the "EDT_Name" control
SAI_Name Size = 25

// Define the characteristics of a Font variable
Font1 is Font
Police1.Nom = "Arial"
Font1.Size = 14
Police1.Angle = 45
// Apply the font to "MyControl"
MyFont Field = Font 1

Syntax

Finding out the size of a Font variable, the maximum number of characters found in a control Hide the details

<Result> = <Element to use>.Size

<Result>: Integer

Size (in picas) of the specified font.
Maximum number of characters found in the specified control or 0 if the specified control has no limit.
Number of table columns if the specified control is a table.

<Element to use>: Optional Font variable or name of control

Name of the Font variable to use.
Name of control to use

Modifying the size of a Font variable, the maximum number of characters found in a control Hide the details

<Element to use>: Optional Font variable or name of control

Name of the Font variable to use.
Name of control to use.

<New size>: Integer

New size (in picas) for the specified font.
Maximum number of characters found in the specified control or 0 if the specified control has no limit.
Remark: The number of columns found in a Table control cannot be modified.

Finding out the size of an item Hide the details

<Result>: Integer

Maximum number of characters supported by the specified item,
0 for the memos.

<Data file>: Character string (with or without quotes)

Name of data file used. This name was defined in the data model editor or by the File description type.

<Item>: Character string (with or without quotes)

Name of item used. This name was defined in the data model editor or by the Item description type.
If this item is a text item, number of characters in the item.
If this item is a time item, the number of characters is used to identify the item format:
Number of characters
in the Time item Format of Time item
2 HH
4 HHMM
6 HHMMSS
8 HHMMSSCC
9 HHMMSSCCC

Defining the size (number of characters) of an item described by programming Hide the details

<Item>: Character string (with or without quotes)

Name of item used. This name was defined by the Item description type.
If this item is a text item, number of characters in the item.
If this item is a time item, the number of characters is used to identify the item format:
Number of characters in the Time item Format of Time item
2 HH
4 HHMM
6 HHMMSS
8 HHMMSSCC
9 HHMMSSCCC

<Number of characters>: Integer

New maximum number of characters supported by the specified item.

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, nom and Underlined.
Only the following properties can be used with the Font type: Angle, Barred, Color, Bold, Italics, nom, Underlined, 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 found in a window or in a page (Font property for the window or page controls).
In the controls of a report (Font property of controls in a report).

Number of characters

If the maximum number of characters that was specified is less than the number of characters currently found in the control:

The content of the control is not modified on the screen.
The value of the control includes all the characters displayed in the control.

Multiline edit control

0. For example:

// "EDT_Address" is a multiline edit control
SAI_Address.Size = 5
EDT_Address = "ABCDEFGHI"
// "EDT_Address" contains "ABCDEFGHI"

Control with input mask

The Property Size must not be used to change the maximum number of characters contained in fields with an input mask.. Indeed, the maximum number of characters found in the control depends on the input mask defined for this control.

Limits

In a data file HFSQL, the property Size applies only to text and Time fields.

edit controls,
tables (in read-only),
table columns,
editable combo boxes.

In anpage, the Property Size applies only in get to:

edit controls,
tables.

The Property Size applies only to the following items:

Edit control.
Combo Box.
Table.
Table column.

The Property Size is available on the columns of an table but it is not available on an Table control.