ONLINE HELP
 WINDEVWEBDEV AND WINDEV MOBILE

This content has been translated automatically.  Click here  to view the French version.
Help / WLanguage / WLanguage functions / Controls, pages and windows / Invalid input functions
  • Characteristics of the verification/detection of controls that require data input/contain invalid data
  • Miscellaneous
WINDEV
WindowsLinuxJavaReports and QueriesUser code (UMC)
WEBDEV
WindowsLinuxPHPWEBDEV - Browser code
WINDEV Mobile
AndroidAndroid Widget iPhone/iPadIOS WidgetApple WatchMac Catalyst
Others
Stored procedures
Detects and signals an error on required controls left empty and/or controls with invalid data.
Example
// Evénement Autorisation de fermeture d'une fenêtre
IF InvalidInputDetect() THEN
	RETURN False
ELSE 
	RETURN True
END
Syntax
<Result> = InvalidInputDetect([<Element used>])
<Result>: Boolean
  • True if at least one required control is left empty or contains invalid data,
  • False otherwise.
<Element used>: Optional control name or window name
Name of the control or window to be checked. If the control is a container (Tab control, Supercontrol, etc.), all its controls will be checked.
If this parameter is not specified, all the controls in the current window will be checked.
Remarks

Characteristics of the verification/detection of controls that require data input/contain invalid data

The input will be checked in the following types of controls:
  • Radio Button control/ switch: if the mandatory input option has been activated (or property MandatoryInput to True), check that at least one option is selected.
  • Grading field: if the mandatory input option has been activated (or property MandatoryInput to True), checks that a grade has been allocated.
  • Combo input if the mandatory input option has been activated (or Property MandatoryInput at True), verifies that a value has been entered or selected in the combo.
    If an input mask has been used, the function checks that the entered data matches this mask.
    If a custom mask with an InputMask variable is used, the verification is performed by executing the procedure associated with the CheckIfValidInput property of this mask.
  • Combo without input If the mandatory input option has been activated (or Property MandatoryInput to True), verifies that a value has been selected in the combo.
  • Edit control field if the mandatory input option has been activated (or Property MandatoryInput to True), verifies that a value has been entered or selected in the Edit control.
    If an input mask has been used, the function checks that the entered data matches this mask. If a custom mask with an InputMask variable is used, the verification is performed by executing the procedure associated with the CheckIfValidInput property of this mask.
Only active and visible controls are checked.

Miscellaneous

  • The function sets focus to the first control detected according to the tab order.
  • You can customize the error display mode in the description window of the relevant controls.
  • The control will no longer be considered as containing errors once the data is edited by the user or programmatically.
  • To know which controls are required/contain invalid data without highlighting them, use InvalidInputListControl.
  • The MandatoryInputMessage and InvalidInputMessage properties are used to customize the error messages displayed in case of invalid/required input.
  • Special case: Edit control or combo box with custom mask via a InputMask type variable. If the control does not have focus when InvalidInputDetect is called, the text displayed in the control will first be formatted with the FormatOnEntry property of the mask before checking its validity.
Business / UI classification: UI Code
Component: wd300obj.dll
Minimum version required
  • Version 26
This page is also available for…
Comments
Planes
Only controls of the currently active plane of the window are taken into account. You should itterate through all planes to check other controls as well (tip : use DisplayEnabled False/True to avoid flicker due to redraw)
Ariezona
17 Feb. 2022

Last update: 03/27/2025

Send a report | Local help