Application: gvSIG desktop » Library: org.gvsig.tools

    /*

     * (non-Javadoc)

     * 

     * @seeorg.gvsig.tools.swing.api.dynobject.dynfield.JDynFieldComponent#

     * addValueChangedListener

     * (org.gvsig.tools.swing.api.dynobject.ValueChangedListener)

     */

    public void addValueChangedListener(ValueChangedListener listener) {

        // If it was the first item, we need to

        // initialize Component listeners

        // add listener to the dynfield set of listeners

        listeners.add(listener);

        // set supplementary listeners.

        this.setJDynFieldComponentListeners();

    }

     * The {@link JDynFieldComponent} can use this function to add any code

     * necessary

     * once all swing components have been initialized.

    protected abstract void afterUI();

    /**

     * Then all {@link ValueChangedListener}s are fired to alert them

     * to check if the value has changed via the {@link getValue()} function of

     * the {@link JDynFieldComponent}.

     */

    public abstract void fireValueChangedEvent();

    /**

     * Gets the default value of the {@link ValueField} object.

     * 

     * @return

     *         the default value of the {@link ValueField} object.

     */

    public Object getDefaultFieldValue() {

        return this.getValueField().getDefaultFieldValue();

     * Returns the {@link DynField} being rendered.

     * 

     * @return the {@link DynField}

    public DynField getDynField() {

        return getValueField().getDynField();

    }

     * Gets the current value of the {@link ValueField} object.

     * 

     * @return

     *         the current value of the {@link ValueField} object.

    public Object getFieldValue() {

        return this.getValueField().getFieldValue();

    }

     * Gets the {@link ValueField} object.

     * 

     * @return

     *         the {@link ValueField} object.

    private ValueField getValueField() {

        return this.parent;

    }

     * Inits the JDynFieldComponent logic to create its components and check its

     * values.

    protected void init() {

        this.initData();

        this.initUI();

        if (this.getDynField().isReadOnly()) {

            this.setReadOnly();

        }

        this.setValue(getInitialValue());

        this.afterUI();

     * JDynFieldComponents can use this function to initialize any

     * data containers before the swing components are created.

    protected abstract void initData();

     * {@link JDynFieldComponent}s can use this function to initialized any

     * swing components to be used afterwards, and specify their

     * default settings.

     */

    protected abstract void initUI();

    /**

     * Sets the current value of the {@link JDynFieldComponent} to the

     * {@link DynObject} value via the {@link ValueField} object.

     * 

     */

    public void setFieldValue(Object value) {

        this.getValueField().setFieldValue(value);

    }

    protected abstract void setJDynFieldComponentListeners();

    /**

     * The {@link JDynFieldComponent} can implement this function to set the

     * swing

     * components that represent this {@link DynField} to readOnly mode.

    protected abstract void setReadOnly();

     * Sets the value to the {@link JDynFieldComponent}. With this logic, it

     * checks first

     * if it is a null value or not. Then all {@link ValueChangedListener}s are

     * fired

     * to alert them to check if the value has changed via the {@link

     * getValue()} function.

     * @param value

     *            the value to be set into the swing component.

    public void setValue(Object value) {

        if (value == null) {

            setNullValue();

        } else {

            setNonNullValue(value);

        }

        this.fireValueChangedEvent();