(incubating) | The Free and Open Productivity Suite

Developer's Guide

API

SDK

Tips 'n' Tricks

Miscellaneous

Content for OpenOffice.org version 3.3.
Overview Module Use Devguide Index
Services' Summary Interfaces' Summary Properties' Summary Services' Details Interfaces' Details Properties' Details

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

unpublished service ValidatableControlModel
Usage Restrictions
not published
Description
specifies the model of a form control which supports live validation of its input.

Validatable control models support setting a validator with dynamic validity constraints, and broadcasting changes in their value as well as the validity of their value.
Included Services - Summary
::com::sun::star::form::FormControlModel

specifies the basic functionality for a form control model (details)
Exported Interfaces - Summary
XValidatableFormComponent

enables support for validating the value of the control model (details)
XValidityConstraintListener

enables support for validators with dynamic validity constraints. (details)
Included Services - Details
::com::sun::star::form::FormControlModel
Description
specifies the basic functionality for a form control model

Via this service, validatable control models inherit the ::com::sun::star::util::XCloneable interface.
If an validatable control model, at which a validator has been set (via XValidatable::setValidator), is being cloned, then the validator is also set at the clone. Effectively, this means that both control model instances share the same validator instance.
Exported Interfaces - Details
XValidatableFormComponent
Description
enables support for validating the value of the control model

Setting an retrieving the current validator of the control model is possible via the XValidatable interface (which XValidatableFormComponent is derived from).

Easy access to the current value of the control, as well as it's validity (relative to the active validator), is provided by the methods XValidatableFormComponent::isValid and XValidatableFormComponent::getCurrentValue.

Note that the type of the value provided by XValidatableFormComponent::getCurrentValue is not specified here, but depends on the concrete control type.
XValidityConstraintListener
Description
enables support for validators with dynamic validity constraints.

As soon as a validator is set via XValidatable::setValidator, the validatable control model registers itself as listener. If the validity constraint of the validator changes, the ValidatableControlModel re-validates it's current valid, and broadcasts any resuling changes to all its XFormComponentValidityListener, if necessary.

 Top of Page

Copyright © 1995, 2010, Oracle and/or its affiliates. All rights reserved. Oracle and Java are registered trademarks of Oracle and/or its affiliates. Other names may be trademarks of their respective owners.

Apache OpenOffice is an effort undergoing incubation at The Apache Software Foundation (ASF), sponsored by the Apache Incubator. Incubation is required of all newly accepted projects until a further review indicates that the infrastructure, communications, and decision making process have stabilized in a manner consistent with other successful ASF projects. While incubation status is not necessarily a reflection of the completeness or stability of the code, it does indicate that the project has yet to be fully endorsed by the ASF.

Copyright & License
Apache and the Apache feather logos are trademarks of The Apache Software Foundation. OpenOffice.org and the seagull logo are registered trademarks of The Apache Software Foundation. Other names appearing on the site may be trademarks of their respective owners.