xHarbour Reference Documentation > Function Reference

GuiGetPostValidate()

Validates data after editing.

Syntax

GuiGetPostValidate( <oGet>, <oControl>, [<oGetMsg>] ) --> lDataIsValid

Arguments

<oGet>

This must be the Get object that has input focus. It is determined with GetActive().

<oControl>

This ia an additional text mode Control object associated with the Get object, such as a HBCheckBox() or HBListBox() object.

<oGetMsg>

Optionally, a GetMssgLine() object can be specified. It displays a message associated with <oGet> in the status line.

Return

The function returns .T. (true) if the edited value is valid before the currently active Get looses input focus, otherwise .F. (false) is returned.

Description

GuiGetPostValidate() is a utility function of the Get system used for validating edited data. It is automatically called within the Get system while READ is active. The rules for data validation are defined with the VALID or RANGE option of the @...GET command, or via a code block assigned to oGet:postBlock. When data validation fails, the input focus remains with the current Get entry field, or associated control, respectively.

Note:  the prefix Gui comes from Clipper 5.3 and may be misleading. It has nothing to do with a Graphical User Interface. All Gui functions of the Get system operate with Get objects associated with text mode controls that mimick true GUI controls, such as menus, check boxes or radio buttons, for example.

Info

See also:	@...GET, Get(), GuiGetPreValidate(), READ
Category:	Get system
Source:	rtl\getsys.prg
LIB:	xhb.lib
DLL:	xhbdll.dll