org.itsnat.comp.button

Interface ItsNatButton

All Superinterfaces:

ItsNatComponent, ItsNatElementComponent, ItsNatUserData

All Known Subinterfaces:

ItsNatButtonCheckBox, ItsNatButtonLabel, ItsNatButtonNormal, ItsNatButtonRadio, ItsNatButtonToggle, ItsNatFreeButtonNormal, ItsNatFreeButtonNormalLabel, ItsNatFreeButtonToggle, ItsNatFreeCheckBox, ItsNatFreeCheckBoxLabel, ItsNatFreeRadioButton, ItsNatFreeRadioButtonLabel, ItsNatHTMLAnchor, ItsNatHTMLAnchorLabel, ItsNatHTMLButton, ItsNatHTMLButtonLabel, ItsNatHTMLInputButton, ItsNatHTMLInputButtonNormal, ItsNatHTMLInputButtonToggle, ItsNatHTMLInputCheckBox, ItsNatHTMLInputImage, ItsNatHTMLInputRadio, ItsNatHTMLInputReset, ItsNatHTMLInputSubmit

public interface ItsNatButton
extends ItsNatElementComponent

Is the base interface of button components.

A button component manages a javax.swing.ButtonModel, user actions updates this model accordingly. Default button model depends on the concrete button type (normal, toggle etc). Button model listeners may be used to keep track of the button state changes.

In spite of ItsNat specifies interfaces bound to the typical form based buttons, any (X)HTML element can be an ItsNat button (free buttons), however ItsNat does not define a default decoration, button model listeners may be used to decorate any button state.

Author:

Jose Maria Arranz Santamaria

Method Summary

Methods

Modifier and Type	Method and Description
ButtonModel	createDefaultButtonModel() Creates a data model instance appropriated to this component.
ButtonModel	getButtonModel() Returns the current data model of this component.
ItsNatButtonUI	getItsNatButtonUI() Returns the user interface manager of this component.
boolean	isEnabled() Informs whether this button receives UI events.
void	setButtonModel(ButtonModel dataModel) Changes the data model of this component.
void	setEnabled(boolean b) Sets whether this button can receive UI events.

Methods inherited from interface org.itsnat.comp.ItsNatElementComponent

getElement, getItsNatElementComponentUI

Methods inherited from interface org.itsnat.comp.ItsNatComponent

addEventListener, addEventListener, addEventListener, addEventListener, addPropertyChangeListener, addPropertyChangeListener, addVetoableChangeListener, disableEventListener, disableEventListener, dispose, enableEventListener, enableEventListener, getArtifact, getArtifact, getItsNatComponentManager, getItsNatComponentUI, getItsNatDocument, getNode, getPropertyChangeListeners, getPropertyChangeListeners, getVetoableChangeListeners, isDisposed, registerArtifact, removeArtifact, removeEventListener, removeEventListener, removeEventListener, removeEventListener, removePropertyChangeListener, removePropertyChangeListener, removeVetoableChangeListener, setEventListenerParams, setEventListenerParams, setNode

Methods inherited from interface org.itsnat.core.ItsNatUserData

containsUserValueName, getUserValue, getUserValueNames, removeUserValue, setUserValue

Method Detail

getButtonModel

ButtonModel getButtonModel()

Returns the current data model of this component.

Returns:

the current data model

See Also:

setButtonModel(javax.swing.ButtonModel)

setButtonModel

void setButtonModel(ButtonModel dataModel)

Changes the data model of this component.

Current data model is disconnected from this component, and the new data model is bound to this component, every change is tracked and updates the user interfaces accordingly.

If the specified data model is the same instance as the current data model, then is reset, component listener is removed and added again. Use this technique if you want to add a data model listener to be executed before the default component listener.

Parameters:

dataModel - the new data model.

See Also:

getButtonModel()

createDefaultButtonModel

ButtonModel createDefaultButtonModel()

Creates a data model instance appropriated to this component. This instance is not bound to the component.

Returns:

a new data model instance.

getItsNatButtonUI

ItsNatButtonUI getItsNatButtonUI()

Returns the user interface manager of this component.

Returns:

the user interface manager.

isEnabled

boolean isEnabled()

Informs whether this button receives UI events.

Current implementation calls ButtonModel.isEnabled().

Specified by:

isEnabled in interface ItsNatComponent

Returns:

true if button UI is enabled.

See Also:

ItsNatComponent.isEnabled()

setEnabled

void setEnabled(boolean b)

Sets whether this button can receive UI events.

Current implementation calls ButtonModel.setEnabled(boolean)

Specified by:

setEnabled in interface ItsNatComponent

Parameters:

b - true to enable the UI.

See Also:

ItsNatComponent.setEnabled(boolean)