MemoryFormat (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 / Properties associated with windows, pages and controls

Overview
Limits

WINDEV

WEBDEV

WINDEV Mobile

Others

See also

Properties associated with windows, pages and controls

MemoryFormat (Property)

In french: FormatMémorisé

Overview

Two formats are used by the Date and Time edit controls and by the Calendar controls:

The format of the displayed value (called the input mask): this format is used to display the date or time in the Edit control.
The format of the value returned by the program or transferred into an item.

If the input mask and the returned value are not identical, the conversion is automatically performed when saving the associated record.

The format of returned value is typed in the window editor, in the "Details" tab of the description window of Date or Time edit controls.

The MemoryFormat property gets and sets the format of the value returned for:

Date or Time edit controls.
the columns of the Date or Time Table controls.
Calendar controls.
Static Text controls.
the editable Combo Box controls.
the columns of the Table controls displayed by Combo Box controls.

Example

SAI_Date1.FormatMémorisé = "AAAAMMJJ"
Trace(SAI_Date1) // Affichera 20010702
SAI_Date1.FormatMémorisé = "JJ/MM/AAAA"
Trace(SAI_Date1) // Affichera 02/07/2001
SAI_Heure1.FormatMémorisé = "HH:MM"
Trace(SAI_Heure1) // Affichera "14:31"
SAI_Heure1.FormatMémorisé = "HHMMSS"
Trace(SAI_Heure1) // Affichera "143123"

// Format mémorisé d'un champ Combo affichant une liste
Trace(COMBO_SaisieListe.FormatMémorisé)
COMBO_SaisieListe.FormatMémorisé = "AAAMMJJ"
Trace(COMBO_SaisieListe.FormatMémorisé)

// Combo affichant une table
// Format mémorisé d'une colonne de type Date du champ Table
Trace(COMBO_SaisieTable.COL_ColDate.FormatMémorisé)

Syntax

Finding out the returned value Hide the details

<Returned value> = <Control used>.MemoryFormat

<Returned value>: Character string

Format currently used for the returned value of the specified control.
For edit control fields and Table field columns, if this parameter corresponds to an empty string (""), the "As is" option is selected: the returned value then corresponds to the edit control mask (known programmatically via property InputMask).
For the Calendar controls, the default format is used ("YYYYMMDD") if this parameter corresponds to an empty string ("").

<Control used>: Control name

Name of the control used:
"Date" or "Time" edit control,
"Date" or "Time" column of a Table control,
Calendar control.

Modifying the returned value Hide the details

<Control used>.MemoryFormat = <New format>

<Control used>: Control name

Name of the control used:
"Date" or "Time" edit control,
"Date" or "Time" column of a Table control,
Calendar control.

<New format>: Character string

New format used for the returned value of the specified control.
For Edit control fields and Table control columns, if this parameter corresponds to an empty string, the "As is" option is selected: the returned value then corresponds to the input mask (known in programming via the InputMask property).
For the Calendar controls, the default format is used ("YYYYMMDD") if this parameter corresponds to an empty string ("").

Remarks

Limits

The MemoryFormat property applies only to:

"Date" and "Time" edit controls.
"Date" and "Time" columns of a Table control.
Calendar controls.
Static Text controls.
editable Combo Box controls.
columns of a Table control displayed by Combo Box controls.

The MemoryFormat property can only be used with Edit controls.