Size (Property)

WINDEV, WEBDEV AND WINDEV MOBILE
ONLINE HELP

Version:

Home | Sign in | English

Help

Font variable
Number of characters
Multiline edit control
Control with input mask
Limits

WINDEV

WEBDEV

WINDEV Mobile

Others

See also

Size (Property)

In french: Taille

..Size is used to find out and modify the size of an element.

This property can be used to find out and modify:

the size (in picas) of a Font variable.
Note: 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)
- an Item control of a report.
  Note: The maximum number of characters found in a control is defined in the "General" tab of control description.a Static control in a report.
  Note: The maximum number of characters found in a control is defined in the "General" tab of 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.

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
DelivAddress..Size = 50
...
// Define the maximum number of characters found in the "DelivTime" item
DelivTime..Size = 6 // HHMMSS format
...
// Validate the file description
HDescribeFile(Customer)

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

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

Syntax

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

<Result> = <Element name>..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 name>: Character string (with or without quotes)

Name of 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 name>: Character string (with or without quotes)

Name of 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.
Note: The number of columns found in a Table control cannot be modified.

Finding out the size of an item Hide the details

<Result> = <File name>.<Item name>..Size

<Result>: Integer

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

<File name>: 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 name>: 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 name>: 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,
..Charset, ..Orientation, ..StrikeOut, ..Condensed, ..Color, ..Extended, ..Bold, ..Italic, ..Large, ..Name and ..Underline.

This font can be used:

To write text in the drawings (dFont).
To write in the 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 for the report controls).

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

If the maximum number of characters allowed in a multiline edit control is modified by ..Size, you will be able to assign by programming a text containing a number of characters greater than the maximum number specified by ..Size. For example:

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

Control with input mask

..Size must not be used to modify the maximum number of characters found in the controls that include an input mask. Indeed, the maximum number of characters found in the control depends on the input mask defined for this control.

Limits

In an HFSQL data file, ..Size only applies to the text items and to the time items.

In a report, ..Size can only be used on an Item control.

In a report, ..Size can only be used on a Static control.