:: com :: sun :: star :: form :: validation ::

interface XValidator

Methods' Summary
isValid determines whether the given value is valid  
explainInvalid retrieves a justification for the invalidity of the given value  
addValidityConstraintListener registers the given validity listener.  
removeValidityConstraintListener revokes the given validity listener  
Methods' Details
isValid
boolean
isValid( [in] any  Value );

Description
determines whether the given value is valid
Parameter aValue
the value to check for validity
Returns
true if and only if the value is considered valid.
explainInvalid
string
explainInvalid( [in] any  Value );

Description
retrieves a justification for the invalidity of the given value
Parameter aValue
the value which has been recognized as being invalid
Returns
a human-readable string, which explains why the given value is considered invalid.
addValidityConstraintListener
void
addValidityConstraintListener( [in] XValidityConstraintListener  Listener )
raises( ::com::sun::star::lang::NullPointerException );

Description
registers the given validity listener.

Usually, an XValidatable instance will also add itself as validity listener, as soon as the validator is introduced to it.

Implementations which do not support dynamic validity constraints should simply ignore this call.

Throws
::com::sun::star::lang::NullPointerException if the given listener is NULL
See also
XValidityConstraintListener
removeValidityConstraintListener
void
removeValidityConstraintListener( [in] XValidityConstraintListener  Listener )
raises( ::com::sun::star::lang::NullPointerException );

Description
revokes the given validity listener
Throws
::com::sun::star::lang::NullPointerException if the given listener is NULL
See also
XValidityConstraintListener
Top of Page