ONLINE HELP
 WINDEVWEBDEV AND WINDEV MOBILE

This content has been translated automatically.  Click here  to view the French version.
Help / WLanguage / WLanguage properties / Various properties
  • Font variable
  • Number of characters
  • Multiline Edit control
  • Control with input mask
  • Limitations
WINDEV
WindowsLinuxJavaReports and QueriesUser code (UMC)
WEBDEV
WindowsLinuxPHPWEBDEV - Browser code
WINDEV Mobile
AndroidAndroid Widget iPhone/iPadIOS WidgetApple WatchMac Catalyst
Others
Stored procedures
The Size property is used to determine and change 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 name of a font must correspond to one of the fonts installed on the current workstation.. 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 Text control in a report.
      Note: The maximum number of characters contained in a field is defined in the "General" tab of the field description.
  • the maximum size of a text item (character string, text memo, character) defined in the data model editor or programmatically.
  • the maximum size of a Time item defined in the data model editor or programmatically.
This property can also be used to find out:
  • the number of columns in a Table control.
// Définir le nombre maximum de caractères contenus dans la rubrique "AdresseLiv"
AdresseLiv.Taille = 50
...
// Définir le nombre maximum de caractères contenus dans la rubrique "HeureLiv"
HeureLiv.Taille = 6 // Format HHMMSS
...
// Valide la description du fichier de données
HDescribeFile(Client)
// Modifier le nombre maximum de caractères contenus dans le champ "SAI_Nom"
SAI_Nom.Taille = 25
iPhone/iPadIOS Widget
// Définir les caractéristiques d'une variable de type Police
Police1 is Font
Police1.Nom = "Arial"
Police1.Couleur = LightYellow
Police1.Taille = 14
Police1.UnitéTaille = unitPoint
Police1.Angle = 45
// Appliquer la police au champ "MonChamp"
MyControl.Police = Police1
Syntax

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

<Result> = <Element to handle>.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 handle>: Optional Font variable or name of control
  • Name of the Font variable to be used.
  • Name of the control to be used

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

<Element to handle>.Size = <New size>
<Element to handle>: Optional Font variable or name of control
  • Name of the Font variable to be used.
  • Name of the control to be used.
<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: It is not possible to change the number of columns in a Table field..

Finding out the size of an item Hide the details

<Result> = <Data file>.<Item>.Size
<Result>: Integer
  • Maximum number of characters supported by the specified item,
  • 0 for the memos.
<Data file>: Character string
Name of the data file used. This name was defined in the data model editor or with the File Description type.
<Item>: Character string
Name of the item used. This name was defined in the data model editor or with 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
2HH
4HHMM
6HHMMSS
8HHMMSSCC
9HHMMSSCCC
iPhone/iPadIOS Widget

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

<Item>.Size = <Number of characters>
<Item>: Character string
Name of the item used. This name is defined with 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 itemFormat of Time item
2HH
4HHMM
6HHMMSS
8HHMMSSCC
9HHMMSSCCC
<Number of characters>: Integer
New maximum number of characters supported by the specified item.
Remarks
AndroidAndroid Widget iPhone/iPadIOS Widget

Font variable

A font can be created from a Font variable.
To define the font characteristics, use:
This font can be used:
AndroidAndroid Widget This font can only be used in the controls of a window (Font property).

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 changed with the Size property, you will be able to assign a text containing more characters than the number that was defined. For example:
// "SAI_Adresse" est un champ de saisie multiligne
SAI_Adresse.Taille = 5
SAI_Adresse = "ABCDEFGHI" 
// "SAI_Adresse" contient "ABCDEFGHI"

Control with input mask

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

Limitations

In HFSQL data files, the Size property applies only to text and time items.
In a report, the Size property can only be used on Static Text controls.
Android The Size property can be used on the columns of a Table control, but not on a Table control.
iPhone/iPad The Size property is available Table controls and on the columns of Table controls.
Minimum version required
  • Version 11
This page is also available for…
Comments
Click [Add] to post a comment

Last update: 09/24/2024

Send a report | Local help