AddFocusCallback

Adds a callback that is invoked when a field or control is focused or blurred.

Parameters

Name	Type	Description
`objname`	String	The name of the field or control to find.
`callback`	Function	The function to be invoked when the field or control is focused or blurred.
`focus`	Boolean	Whether to invoke the callback when the field or control is focused or blurred.

Return Value

Result	Value
(none)

Example

This example registers a named function to be called when a field is focused or blurred:

function customFocusCallback()
{
    if ( IsFieldEmpty( "Description" ) )
    {
         ShowErrorDiv( true, "A description is required" );
    }
    else
    {
         ShowErrorDiv( false );
    }
}
AddFocusCallback( "Description", customFocusCallback, false );

Comments

Callbacks are invoked in the order in which they are added. This callback can be used to perform validation or other data verification. If you want to display a field validation error, call MakeFieldInvalid from this callback so that any required or invalid field errors are automatically processed.

This method can be used with all field types and all input controls. For Multi-Selection, Multi-Relational, Multi-User, and Multi-Group fields, with the "Allow searching" field style, the focus or blur must occur on the right-hand side of the list box.