Types of Edit controls

ONLINE HELP
WINDEV, WEBDEV AND WINDEV MOBILE

Version:

Home | Sign in | English

Help

Editors

Controls (window/page/report)

Controls

Edit control

Types of Edit controls

The different types of Edit controls

See also

Types of Edit controls

The different types of Edit controls

Text Edit control

This type of Edit control is used to show or enter character strings (name, address, etc.).

Remarks:

Text Edit controls can display a Delete ("X") button. This button allows the user to delete the content of the control. The button can be displayed in the input area:
- only when the user enters data in the control.
  - only when the control loses focus.
    Remark: In iOS 7 only, the "X" sill appears when the user enters data in the control.
  - always (whether the input cursor is in the control or not).
You can insert emojis in the Edit control. If the information typed must be saved in a database, the linked item must be in Unicode format (Unicode string or text memo) to store the Emojis.
When a Text Edit control is enlarged in the editor, it automatically becomes a multiline Edit control.

Multiline Text Edit control

This type of Edit control is used to show or enter multiple lines separated by a "Carriage Return".

Remarks:

If the lines are separated by a "Carriage Return", you have the ability to display a vertical or horizontal scrollbar.
You can also display web addresses and file paths as links.
When a Text Edit control is enlarged in the editor, it automatically becomes a multiline Edit control.

RTF Text Edit control

This type of Edit control is used to show and enter RTF content. For more details, see Handling RTF in an Edit control.

For applications running on Windows Vista (or later) or in Tablet PC, you can include the "Handwritten input (PC tablet)" option. This option allows the user to directly write in the control using the mouse or a stylus. This feature is available by default in mobile applications.

HTML Text Edit control

This type of control is used to format rich text.

Characteristics:

A toolbar automatically appears above the control to allow setting the attributes (link, bold, italic, etc.).
To enter an image in this type of control, you must specify the address of the image.
The user cannot open the links in the control directly. The links will work if the HTML content is displayed in an HTML control.

For more details, see Handling HTML text in an Edit control.

New in version 28

Edit control with Markdown text (read-only)

This type of Edit control is used to display Markdown text. The user can select or scroll through this text.

Reminder: The "Support Markdown" option in the "UI" tab of the Edit control description window applies only to the caption, tooltip and tokens associated with the control. This property does not apply to the content of the Edit control.

To change the type of the Edit control (from Text to Markdown, for example), use the DisplayAsMarkdown property.

Password Edit control

In this type of control, all characters entered are replaced with asterisks on the screen.

The user can check the password entered (AAF). For more details, see Showing passwords (AAF).

Numeric, Currency or Currency + Euro Edit control

These different types of controls allow you to handle numerical values:

The Numeric Edit control is used to show or enter numeric values (weight, etc.). The "+++" characters are displayed if the control is not large enough to display the entire number.
The Currency Edit control is used to show or enter currency values.
The Currency + Euro Edit control is used to handle prices, for example.
This type of Edit control is not available.

The Numeric, Currency and Currency + Euro edit controls can display a calculator button allowing the user to perform a calculation ("Display calculator button" option). Several AAFs (Automatic Application Features) are available for this type of control (e.g., change the value with the mouse wheel). For more details, see AAFs for numeric controls.

Date Edit control

This type of Edit control is used to show or enter dates.

The user can use the "+" and "-" keys on the numeric keypad to change the date.

If the control is not in a popup, you can display a calendar button to allow the user to enter the date ("Display a calendar button" option). In this case, you can define the characteristics of the calendar.

AAF (Automatic Application Feature): If the Calendar button is not displayed, the user will still be able to enter a date in a calendar ("Calendar" in the context menu of the control). To delete this AAF, use AAFDisable with the constant aafCalendar. For more details, see AAFs for Date controls.

To use a date picker, the input mask must be of type:

"Date picker",
"Date and Time picker".

Time Edit control

This type of control is used to show or enter times.

To enable the time picker, use the "Time picker" input mask.

Duration Edit control

This type of control is used to show or enter durations.

To enable the duration picker, use the "Duration picker" input mask.

Upload Edit control

This type of control is used to manage the file upload.

Text token Edit control

This type of control is used to manage tokens in Edit controls.

For more details, see Managing a Text token Edit control.

This type of Edit control is not available.