PC SOFT

ONLINE HELP
 WINDEVWEBDEV AND WINDEV MOBILE

Home | Sign in | English EN
This content has been translated automatically. Click here to view the French version.
  • Overview of edit control
  • Create an "Edit" control
  • Main characteristics of edit control
  • Type of an edit control
  • Types and masks
  • Displaying a hint text in an Edit control
  • Customizing the alphanumeric keypad
  • Swap
WINDEV
WindowsLinuxUniversal Windows 10 AppJavaReports and QueriesUser code (UMC)
WEBDEV
WindowsLinuxPHPWEBDEV - Browser code
WINDEV Mobile
AndroidAndroid Widget iPhone/iPadIOS WidgetApple WatchMac CatalystUniversal Windows 10 App
Others
Stored procedures
Overview of edit control
The edit control allows the user to type information. The edit control can also be used to view information.
Versions 15 and later
Android Edit controls are now available for Android applications.
New in version 15
Android Edit controls are now available for Android applications.
Android Edit controls are now available for Android applications.
Versions 16 and later
iPhone/iPad Edit controls are now available for iPhone/iPad applications.
New in version 16
iPhone/iPad Edit controls are now available for iPhone/iPad applications.
iPhone/iPad Edit controls are now available for iPhone/iPad applications.
Versions 18 and later
Universal Windows 10 App Edit controls are now available for applications in Windows Store apps mode.
New in version 18
Universal Windows 10 App Edit controls are now available for applications in Windows Store apps mode.
Universal Windows 10 App Edit controls are now available for applications in Windows Store apps mode.

Create an "Edit" control

To create an "Edit" control:
  1. On the "Creation" pane, in the "Usual controls" group, click .
  2. Click where the control will be created in the window or page. The control appears in the editor.
Remark: You also have the ability to create an edit control from a list of preset controls by expanding "Edit". The list of available controls is displayed with the project skin template. Simply click the control you want to create in the editor.
To view the control characteristics, select "Description" in the context menu.
Report editor: You also have the ability to create an edit control in a report. For more details, see Input in the reports.
Main characteristics of edit control

Type of an edit control

The format of an edit control depends on the type of information displayed or entered. The following types of edit controls can be created:
  • Text to display or enter a character string (name, address, etc.).
  • Multiline text to display or enter several lines separated by a "Carriage Return".
  • Password: when typing information, all characters will be replaced by stars on the screen.
  • Numeric to display or enter a numeric value (weight, etc.). The "+++" characters are displayed if the control is not large enough to display the entire number.
  • Currency to display or enter monetary values.
  • Currency + Euro to manage prices for example
  • Date to display or enter dates.
  • Time to enter or display times.
  • Duration to enter or display durations.
  • Versions 24 and later
    Text tokens to manage an input with tokens.
    New in version 24
    Text tokens to manage an input with tokens.
    Text tokens to manage an input with tokens.

Types and masks

Input mask: Several input masks can be used for each type of edit control.
These input masks are multilingual: different input masks can be selected according to the runtime language of the project. For more details, see Multilingual feature in the controls.
These input masks can be modified by programming with InputMask.
Versions 17 and later
iPhone/iPad The keyboard displayed when entering data in the control automatically adapts to the selected input mask. For example, the numeric keyboard will be automatically displayed to enter values in a control using a numeric input mask.
New in version 17
iPhone/iPad The keyboard displayed when entering data in the control automatically adapts to the selected input mask. For example, the numeric keyboard will be automatically displayed to enter values in a control using a numeric input mask.
iPhone/iPad The keyboard displayed when entering data in the control automatically adapts to the selected input mask. For example, the numeric keyboard will be automatically displayed to enter values in a control using a numeric input mask.
Versions 17 and later
Android Display mask: You can also define display masks for some types of controls (Currency, Currency + Euro, Date, Time and Duration). These display masks are used to define the characteristics of the control when it is not in edit.
For example, a Date control can have:
  • the input mask: "MM/DD/YYYY".
  • the display mask: "DDDD DD MMMM YYYY" (corresponding to the spelled out date).
The display masks can be multilingual and they can be modified by programming with DisplayMask.
New in version 17
Android Display mask: You can also define display masks for some types of controls (Currency, Currency + Euro, Date, Time and Duration). These display masks are used to define the characteristics of the control when it is not in edit.
For example, a Date control can have:
  • the input mask: "MM/DD/YYYY".
  • the display mask: "DDDD DD MMMM YYYY" (corresponding to the spelled out date).
The display masks can be multilingual and they can be modified by programming with DisplayMask.
Android Display mask: You can also define display masks for some types of controls (Currency, Currency + Euro, Date, Time and Duration). These display masks are used to define the characteristics of the control when it is not in edit.
For example, a Date control can have:
  • the input mask: "MM/DD/YYYY".
  • the display mask: "DDDD DD MMMM YYYY" (corresponding to the spelled out date).
The display masks can be multilingual and they can be modified by programming with DisplayMask.
iPhone/iPad

Displaying a hint text in an Edit control

The hint text is used to display a help text in the empty edit control. This help text is automatically erased as soon as the user types the first character in the control.
Example of tooltip
This hint text is available for:
  • the text edit controls.
  • iPhone/iPad the Numeric, Currency and Currency + Euro edit controls.
    To show the hint text in Numeric, Currency or Currency + Euro edit controls, the option "Blank if zero" must be checked ("Details" tab of the control description).
    You can also display the lower bound and the upper bound of the numeric edit control:
    • in the hint text ("Display the bounds in the hint text" in the "Details" tab of the control description).
    • in the control tooltip ("Display the bounds in the tooltip" in the "Details" tab of the control description).
The help text can be typed:
  • in the Edit control description window ("Help" tab in WINDEV/WINDEV Mobile and "Content" tab in WEBDEV).
  • by programming with Indication.
iPhone/iPad The style of the hint text displayed in the control can be configured in the "Style" tab. By default, it corresponds to the style of the input area, in gray and italic. To modify it, simply select "Hint text" and check "Customize the style of the hint text".
Versions 22 and later
HintTextColor is used to find out and modify the color of information text by programming.
New in version 22
HintTextColor is used to find out and modify the color of information text by programming.
HintTextColor is used to find out and modify the color of information text by programming.
    To view the characteristics of the control, select "Description" in the context menu.
    Versions 17 and later
    Android

    Customizing the alphanumeric keypad

    In the Android applications, an alphabetical keyboard is automatically displayed during the input in a text control. This keyboard allows the user to enter the desired text.
    This keyboard includes a button (bottom right) that can be customized:
    To configure this button:
    1. Go to the "Details" tab of the Edit control description window.
    2. In the "Keyboard button" option, select the desired type of button. Depending on the selected type, the system will display the corresponding button in the current language on the device.
    3. Validate.
    The event associated with this button can be entered in the code editor. It corresponds to the optional event "Validation via keyboard". For more details, see Events associated with the Edit control.
    New in version 17
    Android

    Customizing the alphanumeric keypad

    In the Android applications, an alphabetical keyboard is automatically displayed during the input in a text control. This keyboard allows the user to enter the desired text.
    This keyboard includes a button (bottom right) that can be customized:
    To configure this button:
    1. Go to the "Details" tab of the Edit control description window.
    2. In the "Keyboard button" option, select the desired type of button. Depending on the selected type, the system will display the corresponding button in the current language on the device.
    3. Validate.
    The event associated with this button can be entered in the code editor. It corresponds to the optional event "Validation via keyboard". For more details, see Events associated with the Edit control.
    Android

    Customizing the alphanumeric keypad

    In the Android applications, an alphabetical keyboard is automatically displayed during the input in a text control. This keyboard allows the user to enter the desired text.
    This keyboard includes a button (bottom right) that can be customized:
    To configure this button:
    1. Go to the "Details" tab of the Edit control description window.
    2. In the "Keyboard button" option, select the desired type of button. Depending on the selected type, the system will display the corresponding button in the current language on the device.
    3. Validate.
    The event associated with this button can be entered in the code editor. It corresponds to the optional event "Validation via keyboard". For more details, see Events associated with the Edit control.
    Swap
    Versions 20 and later
    Universal Windows 10 AppAndroidiPhone/iPad WINDEV and WINDEV Mobile allow you to automatically transform an edit control into several static controls:
    1. Select the edit control to transform.
    2. On the "Modification" pane, in the "Transformations" group, expand "Refactoring and swapping" and select "Edit control to Statics".
    A static control is automatically created for the caption of the edit control and also for the input area.
    New in version 20
    Universal Windows 10 AppAndroidiPhone/iPad WINDEV and WINDEV Mobile allow you to automatically transform an edit control into several static controls:
    1. Select the edit control to transform.
    2. On the "Modification" pane, in the "Transformations" group, expand "Refactoring and swapping" and select "Edit control to Statics".
    A static control is automatically created for the caption of the edit control and also for the input area.
    Universal Windows 10 AppAndroidiPhone/iPad WINDEV and WINDEV Mobile allow you to automatically transform an edit control into several static controls:
    1. Select the edit control to transform.
    2. On the "Modification" pane, in the "Transformations" group, expand "Refactoring and swapping" and select "Edit control to Statics".
    A static control is automatically created for the caption of the edit control and also for the input area.
    Related Examples:
    The edit control Unit examples (WINDEV): The edit control
    [ + ] Using an edit control.
    The RTF edit control Unit examples (WINDEV Mobile): The RTF edit control
    [ + ] Using text in RTF format in the edit controls.
    This format is very useful to format and view data.
    The special characters Unit examples (WINDEV): The special characters
    [ + ] Handling special characters in an RTF control and viewing the ASCII and ANSI codes.
    The voice recognition functions Unit examples (WINDEV): The voice recognition functions
    [ + ] Using the voice recognition functions.
    The voice commands of Windows Vista (or Windows XP, with a specific software) are used to control WINDEV applications with the voice.
    A WINDEV application already responds to the voice when the user dictates in an edit control or spells out the caption of a button.
    You also have the ability to program a specific voice command to perform a specific action.
    Advanced input mask Unit examples (WINDEV): Advanced input mask
    [ + ] Handling the input masks in WINDEV:
    - Defining the format of positive/negative number in a numeric edit control
    - Defining how negative numbers will be displayed in a numeric edit control
    - Defining how the value 0 will be displayed in a numeric edit control
    - Using a regular expression to prevent from typing characters other than 1, 2, 3, 4, 5 and 6.
    - Using a regular expression to "regulate" the input of a French registration number
    WD Search Control Training (WINDEV): WD Search Control
    [ + ] This example explains how to manage an edit control used to perform FullText searches of "google" type in your database.
    WW_Rewali Complete examples (WEBDEV): WW_Rewali
    [ + ] This example is a site for travel booking.

    It proposes travels at very attractive prices.
    You have the ability to choose the travel duration, the start dates, then validate the purchase until the payment via Paypal.

    It is using the "scrolling banner" control and the planes.
    Minimum version required
    • Version 9
    This page is also available for…
    Comments
    Click [Add] to post a comment