ButtonControl

Overview

Package

Class

Use

Tree

Deprecated

Index

Help

Oracle Data-aware Controls Reference

PREV CLASS NEXT CLASS

FRAMES NO FRAMES

SUMMARY: NESTED | FIELD | CONSTR | METHOD

DETAIL: FIELD | CONSTR | METHOD

oracle.dacf.control.swing
Class ButtonControl

java.lang.Object
  java.awt.Component
      java.awt.Container
          javax.swing.JComponent
              javax.swing.AbstractButton
                  javax.swing.JButton
                      oracle.dacf.control.swing.ButtonControl

All Implemented Interfaces:: javax.accessibility.Accessible, Control, ControlEnabledListener, javax.infobus.DataItemChangeListener, java.util.EventListener, java.awt.event.FocusListener, java.awt.image.ImageObserver, InfoBusManagerListener, java.awt.ItemSelectable, java.awt.MenuContainer, java.io.Serializable, javax.swing.SwingConstants

public class ButtonControl
extends javax.swing.JButton
implements Control, ControlEnabledListener, java.awt.event.FocusListener, InfoBusManagerListener

A data aware Button Control based on JButton control.

Version:: PUBLIC
See Also:: Serialized Form

Nested Class Summary

Nested classes inherited from class javax.swing.JButton

javax.swing.JButton.AccessibleJButton

Nested classes inherited from class javax.swing.AbstractButton

javax.swing.AbstractButton.AccessibleAbstractButton, javax.swing.AbstractButton.ButtonChangeListener

Nested classes inherited from class javax.swing.JComponent

javax.swing.JComponent.AccessibleJComponent

Nested classes inherited from class java.awt.Container

java.awt.Container.AccessibleAWTContainer

Nested classes inherited from class java.awt.Component

java.awt.Component.AccessibleAWTComponent, java.awt.Component.BltBufferStrategy, java.awt.Component.FlipBufferStrategy

Field Summary

Fields inherited from class javax.swing.AbstractButton

actionListener, BORDER_PAINTED_CHANGED_PROPERTY, changeEvent, changeListener, CONTENT_AREA_FILLED_CHANGED_PROPERTY, DISABLED_ICON_CHANGED_PROPERTY, DISABLED_SELECTED_ICON_CHANGED_PROPERTY, FOCUS_PAINTED_CHANGED_PROPERTY, HORIZONTAL_ALIGNMENT_CHANGED_PROPERTY, HORIZONTAL_TEXT_POSITION_CHANGED_PROPERTY, ICON_CHANGED_PROPERTY, itemListener, MARGIN_CHANGED_PROPERTY, MNEMONIC_CHANGED_PROPERTY, model, MODEL_CHANGED_PROPERTY, PRESSED_ICON_CHANGED_PROPERTY, ROLLOVER_ENABLED_CHANGED_PROPERTY, ROLLOVER_ICON_CHANGED_PROPERTY, ROLLOVER_SELECTED_ICON_CHANGED_PROPERTY, SELECTED_ICON_CHANGED_PROPERTY, TEXT_CHANGED_PROPERTY, VERTICAL_ALIGNMENT_CHANGED_PROPERTY, VERTICAL_TEXT_POSITION_CHANGED_PROPERTY

Fields inherited from class javax.swing.JComponent

accessibleContext, listenerList, TOOL_TIP_TEXT_KEY, ui, UNDEFINED_CONDITION, WHEN_ANCESTOR_OF_FOCUSED_COMPONENT, WHEN_FOCUSED, WHEN_IN_FOCUSED_WINDOW

Fields inherited from class java.awt.Component

BOTTOM_ALIGNMENT, CENTER_ALIGNMENT, LEFT_ALIGNMENT, RIGHT_ALIGNMENT, TOP_ALIGNMENT

Fields inherited from interface oracle.dacf.control.Control

DEFAULT_INFOBUS_NAME, EVENT_PROPERTY_ROW, EVENT_PROPERTY_ROW_CHANGE, EVENT_PROPERTY_ROW_COUNT, EVENT_PROPERTY_VIEW_CHANGE, EVENT_PROPERTY_VIEW_REFRESHED, EVENT_PROPERTY_VIEW_SCROLLED, EXCLUDE, HIDE, SHOW

Fields inherited from interface javax.swing.SwingConstants

BOTTOM, CENTER, EAST, HORIZONTAL, LEADING, LEFT, NEXT, NORTH, NORTH_EAST, NORTH_WEST, PREVIOUS, RIGHT, SOUTH, SOUTH_EAST, SOUTH_WEST, TOP, TRAILING, VERTICAL, WEST

Fields inherited from interface java.awt.image.ImageObserver

ABORT, ALLBITS, ERROR, FRAMEBITS, HEIGHT, PROPERTIES, SOMEBITS, WIDTH

Constructor Summary
`ButtonControl()` Creates a button with no set text or icon.
`ButtonControl(javax.swing.Icon icon)` Creates a button with an icon.
`ButtonControl(java.lang.String text)` Creates a button with text.
`ButtonControl(java.lang.String text, javax.swing.Icon icon)` Creates a button with initial text and an icon.

Method Summary
`void`	`addNavigatedListener(NavigatedListener listener)` This method is a no-op that is it has no effect
`void`	`addNavigatingListener(NavigatingListener listener)` This method is a no-op that is it has no effect
`void`	`dataItemAdded(javax.infobus.DataItemAddedEvent event)` Indicates that a new item was added to the bound aggregate data item (e.g.
`void`	`dataItemChanged(java.lang.Object oldDataItem, java.lang.Object newDataItem)` Notifies the control that the bound InfoBus DataItem has changed.
`void`	`dataItemDeleted(javax.infobus.DataItemDeletedEvent event)` Indicates that an item was deleted from the bound aggregate data item (e.
`void`	`dataItemRevoked(javax.infobus.DataItemRevokedEvent event)` Indicates that the bound data item (and its sub-items, if any) has been revoked, and is temporarily unavailable.
`void`	`dataItemValueChanged(javax.infobus.DataItemValueChangedEvent event)` Indicates a changed value in the bound data item.
`void`	`enabledChanged(boolean b)`
`void`	`focusGained(java.awt.event.FocusEvent event)` This method is an implementaion side effect
`void`	`focusLost(java.awt.event.FocusEvent event)` This method is an implementaion side effect
`java.awt.Component`	`getComponent()` Returns the AWT component associated with this control.
`java.lang.Object`	`getDataItem()` Returns the InfoBus DataItem this control is bound to.
`java.lang.String`	`getDataItemName()` Returns the name of the InfoBus DataItem this control is bound to.
`java.lang.String`	`getInfoBusName()` Returns the name of the InfoBus this control is connected to.
`boolean`	`isFocusValidated()` Determines whether focus into this control causes validation to occur.
`void`	`processNavigatedEvent(NavigatedEvent event)` This method is a no-op that is it has no effect
`void`	`processNavigatingEvent(NavigatingEvent event)` This method is a no-op in that it has no effect
`void`	`releaseResources(InfoBusManagerReleaseEvent e)` A signalling method used to indicate the the control should free all resources and unregister any listeners that it has registered.
`void`	`removeNavigatedListener(NavigatedListener listener)` This method is a no-op that is it has no effect
`void`	`removeNavigatingListener(NavigatingListener listener)` This method is a no-op in that it has no effect
`void`	`rowsetCursorMoved(javax.infobus.RowsetCursorMovedEvent event)` Indicates that the cursor for the bound `RowsetAccess` data item has changed rows.
`void`	`setDataItemName(java.lang.String dataItemName)` Sets the name of the InfoBus DataItem this control is bound to.
`void`	`setEnabled(boolean b)` An override of java.awt.Component.setEnabled.
`void`	`setFocusValidated(boolean focusValidated)` This method is a no-op that is it has no effect
`void`	`setInfoBusName(java.lang.String infoBusName)` Sets the name of the InfoBus this control is connected to.

Methods inherited from class javax.swing.JButton

configurePropertiesFromAction, getAccessibleContext, getUIClassID, isDefaultButton, isDefaultCapable, paramString, removeNotify, setDefaultCapable, updateUI

Methods inherited from class javax.swing.AbstractButton

addActionListener, addChangeListener, addItemListener, checkHorizontalKey, checkVerticalKey, createActionListener, createActionPropertyChangeListener, createChangeListener, createItemListener, doClick, doClick, fireActionPerformed, fireItemStateChanged, fireStateChanged, getAction, getActionCommand, getActionListeners, getChangeListeners, getDisabledIcon, getDisabledSelectedIcon, getDisplayedMnemonicIndex, getHorizontalAlignment, getHorizontalTextPosition, getIcon, getIconTextGap, getItemListeners, getLabel, getMargin, getMnemonic, getModel, getMultiClickThreshhold, getPressedIcon, getRolloverIcon, getRolloverSelectedIcon, getSelectedIcon, getSelectedObjects, getText, getUI, getVerticalAlignment, getVerticalTextPosition, imageUpdate, init, isBorderPainted, isContentAreaFilled, isFocusPainted, isRolloverEnabled, isSelected, paintBorder, removeActionListener, removeChangeListener, removeItemListener, setAction, setActionCommand, setBorderPainted, setContentAreaFilled, setDisabledIcon, setDisabledSelectedIcon, setDisplayedMnemonicIndex, setFocusPainted, setHorizontalAlignment, setHorizontalTextPosition, setIcon, setIconTextGap, setLabel, setMargin, setMnemonic, setMnemonic, setModel, setMultiClickThreshhold, setPressedIcon, setRolloverEnabled, setRolloverIcon, setRolloverSelectedIcon, setSelected, setSelectedIcon, setText, setUI, setVerticalAlignment, setVerticalTextPosition

Methods inherited from class javax.swing.JComponent

addAncestorListener, addNotify, addPropertyChangeListener, addPropertyChangeListener, addVetoableChangeListener, computeVisibleRect, contains, createToolTip, disable, enable, firePropertyChange, firePropertyChange, firePropertyChange, firePropertyChange, firePropertyChange, firePropertyChange, firePropertyChange, firePropertyChange, firePropertyChange, fireVetoableChange, getActionForKeyStroke, getActionMap, getAlignmentX, getAlignmentY, getAncestorListeners, getAutoscrolls, getBorder, getBounds, getClientProperty, getComponentGraphics, getConditionForKeyStroke, getDebugGraphicsOptions, getDefaultLocale, getGraphics, getHeight, getInputMap, getInputMap, getInputVerifier, getInsets, getInsets, getListeners, getLocation, getMaximumSize, getMinimumSize, getNextFocusableComponent, getPreferredSize, getPropertyChangeListeners, getPropertyChangeListeners, getRegisteredKeyStrokes, getRootPane, getSize, getToolTipLocation, getToolTipText, getToolTipText, getTopLevelAncestor, getTransferHandler, getVerifyInputWhenFocusTarget, getVetoableChangeListeners, getVisibleRect, getWidth, getX, getY, grabFocus, isDoubleBuffered, isLightweightComponent, isManagingFocus, isMaximumSizeSet, isMinimumSizeSet, isOpaque, isOptimizedDrawingEnabled, isPaintingTile, isPreferredSizeSet, isRequestFocusEnabled, isValidateRoot, paint, paintChildren, paintComponent, paintImmediately, paintImmediately, print, printAll, printBorder, printChildren, printComponent, processComponentKeyEvent, processKeyBinding, processKeyEvent, processMouseMotionEvent, putClientProperty, registerKeyboardAction, registerKeyboardAction, removeAncestorListener, removePropertyChangeListener, removePropertyChangeListener, removeVetoableChangeListener, repaint, repaint, requestDefaultFocus, requestFocus, requestFocus, requestFocusInWindow, requestFocusInWindow, resetKeyboardActions, reshape, revalidate, scrollRectToVisible, setActionMap, setAlignmentX, setAlignmentY, setAutoscrolls, setBackground, setBorder, setDebugGraphicsOptions, setDefaultLocale, setDoubleBuffered, setFont, setForeground, setInputMap, setInputVerifier, setMaximumSize, setMinimumSize, setNextFocusableComponent, setOpaque, setPreferredSize, setRequestFocusEnabled, setToolTipText, setTransferHandler, setUI, setVerifyInputWhenFocusTarget, setVisible, unregisterKeyboardAction, update

Methods inherited from class java.awt.Container

add, add, add, add, add, addContainerListener, addImpl, applyComponentOrientation, areFocusTraversalKeysSet, countComponents, deliverEvent, doLayout, findComponentAt, findComponentAt, getComponent, getComponentAt, getComponentAt, getComponentCount, getComponents, getContainerListeners, getFocusTraversalKeys, getFocusTraversalPolicy, getLayout, insets, invalidate, isAncestorOf, isFocusCycleRoot, isFocusCycleRoot, isFocusTraversalPolicySet, layout, list, list, locate, minimumSize, paintComponents, preferredSize, printComponents, processContainerEvent, processEvent, remove, remove, removeAll, removeContainerListener, setFocusCycleRoot, setFocusTraversalKeys, setFocusTraversalPolicy, setLayout, transferFocusBackward, transferFocusDownCycle, validate, validateTree

Methods inherited from class java.awt.Component

action, add, addComponentListener, addFocusListener, addHierarchyBoundsListener, addHierarchyListener, addInputMethodListener, addKeyListener, addMouseListener, addMouseMotionListener, addMouseWheelListener, bounds, checkImage, checkImage, coalesceEvents, contains, createImage, createImage, createVolatileImage, createVolatileImage, disableEvents, dispatchEvent, enable, enableEvents, enableInputMethods, getBackground, getBounds, getColorModel, getComponentListeners, getComponentOrientation, getCursor, getDropTarget, getFocusCycleRootAncestor, getFocusListeners, getFocusTraversalKeysEnabled, getFont, getFontMetrics, getForeground, getGraphicsConfiguration, getHierarchyBoundsListeners, getHierarchyListeners, getIgnoreRepaint, getInputContext, getInputMethodListeners, getInputMethodRequests, getKeyListeners, getLocale, getLocation, getLocationOnScreen, getMouseListeners, getMouseMotionListeners, getMouseWheelListeners, getName, getParent, getPeer, getSize, getToolkit, getTreeLock, gotFocus, handleEvent, hasFocus, hide, inside, isBackgroundSet, isCursorSet, isDisplayable, isEnabled, isFocusable, isFocusOwner, isFocusTraversable, isFontSet, isForegroundSet, isLightweight, isShowing, isValid, isVisible, keyDown, keyUp, list, list, list, location, lostFocus, mouseDown, mouseDrag, mouseEnter, mouseExit, mouseMove, mouseUp, move, nextFocus, paintAll, postEvent, prepareImage, prepareImage, processComponentEvent, processFocusEvent, processHierarchyBoundsEvent, processHierarchyEvent, processInputMethodEvent, processMouseEvent, processMouseWheelEvent, remove, removeComponentListener, removeFocusListener, removeHierarchyBoundsListener, removeHierarchyListener, removeInputMethodListener, removeKeyListener, removeMouseListener, removeMouseMotionListener, removeMouseWheelListener, repaint, repaint, repaint, resize, resize, setBounds, setBounds, setComponentOrientation, setCursor, setDropTarget, setFocusable, setFocusTraversalKeysEnabled, setIgnoreRepaint, setLocale, setLocation, setLocation, setName, setSize, setSize, show, show, size, toString, transferFocus, transferFocusUpCycle

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait

Constructor Detail

ButtonControl

public ButtonControl()

Creates a button with no set text or icon.

ButtonControl

public ButtonControl(javax.swing.Icon icon)

Creates a button with an icon.
Parameters:: icon - the Icon image to display on the button

ButtonControl

public ButtonControl(java.lang.String text)

Creates a button with text.
Parameters:: text - the text of the button

ButtonControl

public ButtonControl(java.lang.String text,
                     javax.swing.Icon icon)

Creates a button with initial text and an icon.
Parameters:: text - the text of the button.; icon - the Icon image to display on the button

Method Detail

enabledChanged

public void enabledChanged(boolean b)

Specified by:: enabledChanged in interface ControlEnabledListener

releaseResources

public void releaseResources(InfoBusManagerReleaseEvent e)

Description copied from interface: InfoBusManagerListener

A signalling method used to indicate the the control should free all resources and unregister any listeners that it has registered.

Specified by:: releaseResources in interface InfoBusManagerListener

focusLost

public void focusLost(java.awt.event.FocusEvent event)

This method is an implementaion side effect

Specified by:: focusLost in interface java.awt.event.FocusListener

focusGained

public void focusGained(java.awt.event.FocusEvent event)

This method is an implementaion side effect

Specified by:: focusGained in interface java.awt.event.FocusListener

setEnabled

public void setEnabled(boolean b)

An override of java.awt.Component.setEnabled.

Specified by:: setEnabled in interface Control

Parameters:: b - boolean flag indicating whether the control is enabled

getInfoBusName

public final java.lang.String getInfoBusName()

Returns the name of the InfoBus this control is connected to.

Specified by:: getInfoBusName in interface Control

Returns:: The name of the InfoBus this control is connected to.
See Also:: Control.getInfoBusName()

setInfoBusName

public final void setInfoBusName(java.lang.String infoBusName)

Sets the name of the InfoBus this control is connected to.

By default, the control is connected to the default InfoBus, named Control.DEFAULT_INFOBUS_NAME.

If the named InfoBus does not exist, it is created automatically.

If the control is already connected to an InfoBus, it is disconnected first.

Specified by:: setInfoBusName in interface Control

Parameters:: infoBusName - The name of the InfoBus to connect to.
See Also:: Control.DEFAULT_INFOBUS_NAME, Control.setInfoBusName(java.lang.String)

getDataItemName

public final java.lang.String getDataItemName()

Returns the name of the InfoBus DataItem this control is bound to.

Specified by:: getDataItemName in interface Control

Returns:: The name of the InfoBus DataItem this control is bound to, or null if the control is unbound.
See Also:: getDataItem(), Control.getDataItemName()

setDataItemName

public final void setDataItemName(java.lang.String dataItemName)

Sets the name of the InfoBus DataItem this control is bound to.

The DataItem with the given name is searched for on the InfoBus, and if found, is bound to this control.

If the control is already bound to a DataItem, it is unbound first.

Specified by:: setDataItemName in interface Control

Parameters:: dataItemName - The name of the DataItem to bind to.
See Also:: getDataItem(), Control.setDataItemName(java.lang.String)

getDataItem

public final java.lang.Object getDataItem()

Returns the InfoBus DataItem this control is bound to.

Specified by:: getDataItem in interface Control

Returns:: The InfoBus DataItem this control is bound to, or null if the control is unbound.
See Also:: Control.getDataItem()

dataItemChanged

public final void dataItemChanged(java.lang.Object oldDataItem,
                                  java.lang.Object newDataItem)

Notifies the control that the bound InfoBus DataItem has changed.

Specified by:: dataItemChanged in interface Control

Parameters:: oldDataItem - The formerly bound DataItem (can be null).; newDataItem - The newly bound DataItem (can be null).
See Also:: Control.dataItemChanged(java.lang.Object, java.lang.Object)

getComponent

public final java.awt.Component getComponent()

Returns the AWT component associated with this control.

Specified by:: getComponent in interface Control

Returns:: The AWT component for this control.
See Also:: Control.getComponent()

isFocusValidated

public final boolean isFocusValidated()

Determines whether focus into this control causes validation to occur.

Specified by:: isFocusValidated in interface Control

Returns:: true if focus into this control causes validation to occur, false otherwise.
See Also:: Control.isFocusValidated()