com.sas.awt
Class AppletVisualComponent

java.lang.Object
  |
  +--java.awt.Component
        |
        +--java.awt.Container
              |
              +--java.awt.Panel
                    |
                    +--java.applet.Applet
                          |
                          +--com.sas.awt.AppletVisualComponent

All Implemented Interfaces:

ComponentInterface, LinkPropertiesInterface, ModelInterface, MultipleValueEventSourceInterface, com.sas.beans.PropertyChangeSource, VetoableChangeSource, ViewInterface, VisualInterface

Direct Known Subclasses:

Applet

public abstract class AppletVisualComponent

extends java.applet.Applet

implements ComponentInterface, VisualInterface, MultipleValueEventSourceInterface

See Also:

Serialized Form

Inner classes inherited from class java.applet.Applet

Applet.AccessibleApplet

Inner classes inherited from class java.awt.Panel

Panel.AccessibleAWTPanel

Inner classes inherited from class java.awt.Container

Container.AccessibleAWTContainer

Inner classes inherited from class java.awt.Component

Component.AccessibleAWTComponent, Component.BltBufferStrategy, Component.FlipBufferStrategy

Fields inherited from class java.awt.Component

BOTTOM_ALIGNMENT, CENTER_ALIGNMENT, LEFT_ALIGNMENT, RIGHT_ALIGNMENT, TOP_ALIGNMENT

Fields inherited from interface java.awt.image.ImageObserver

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

Constructor Summary

AppletVisualComponent()

Method Summary

void	addLink(String property, ComponentInterface linked_component, String linked_property) addLink() adds a link between property on this component and source_property on source_component.
void	addPropertyChangeListener(PropertyChangeListener listener) Adds a PropertyChangeListener to the component.
void	addVetoableChangeListener(VetoableChangeListener listener) Adds a VetoableChangeListener to the component.
boolean	anyPropertyChangeListeners() Return true if there are any PropertyChangeEvent listeners.
void	attachModel(ModelInterface model) Attaches the specified model to this view.
boolean	attachView() attachView is called on the model during an attachModel call on the view.
Object	clone() Return a clone of the object.
Dimension	computePreferredSize() The default implementation of this method calls super.getPreferredSize().
void	detachModel(ModelInterface model) Detaches the specified model from this view.
void	detachView() detachView is called on the model during an detachModel call on the view.
void	dumpComponent() This method prints debugging information about the component.
void	firePropertyChange(PropertyChangeEvent propertyChangeEvent) Report a bound property update to any registered listeners.
void	firePropertyChange(String propertyName, Object oldValue, Object newValue) Report a bound property update to any registered listeners.
void	fireVetoableChange(String propertyName, Object oldValue, Object newValue) Report a constrained property update to any registered listeners.
Color	getBackgroundColor() Returns the background color of the component.
BorderInterface	getBorder() Returns the border drawn around the component.
String	getComponentDescription() This method returns the description of the component.
ComponentInterfaceSupportInfo	getComponentSupportInfo(boolean createIfNecessary) Internal framework method.
Method	getEventMethod(Method listenerMethod) Get the method used to check the value of the event.
String[]	getEventValues(Method listenerMethod) Get the possible values for the listenerInterface method the event is sent to.
static ExtendedBeanInfo	getExtendedBeanInfo() Returns information used by the com.sas.beans.Introspector to augment the automatically introspected information about the component.
Font	getFont() Returns the font used by the component to display text.
Color	getForegroundColor() Returns the foreground color of the component.
int	getHeight() This method returns the vertical size of the component in pixels.
int	getHorizontalPosition() This method returns the horizontal starting position of the component in pixels.
LinkPropertiesInfo	getLinkInfo() Internal framework method.
Dimension	getMinimumSize() Overrides the java.awt.Component getMinimumSize method to return a minimum size of 5,5 for components which do not have a peer.
ModelInterface	getModelInterface()
Dimension	getPreferredSize()
PainterInterface	getPrePainter() Returns the painter used to draw over the background of the component.
Vector	getRequiredInterfaces() The get method for the requiredInterfaces attribute.
int	getVerticalPosition() This method returns the vertical starting position of the component in pixels.
ViewInterfaceSupportInfo	getViewInterfaceSupportInfo() Internal framework method.
VisualInterfaceSupportInfo	getVisualInterfaceSupportInfo() This method is not intended to be called by users.
int	getWidth() This method returns the width of the component in pixels.
void	initialize() The initialize() method was designed to be a synchronization point after the constructor for the object has completed and a number of methods have been called on the component.
void	initializeComponent() Called by the default constructor.
boolean	isDesignTime() This method returns whether the component is in design mode or in run mode.
boolean	isEnabled() Returns whether the component is currently enabled.
boolean	isFocus() isFocus returns whether the component currently has focus.
boolean	isLinked(String property, ComponentInterface linked_component, String linked_property) isLinked() determines if property on this component is linked to source_property on source_component.
boolean	isTransparent() Returns whether the background is not filled with the backgroundColor.
boolean	isVisible() Returns whether the component is currently visible.
void	paint(Graphics g)
void	propertyChange(PropertyChangeEvent e) Handles any property links on this component from the source component.
PropertyLinkInfo[]	queryLinks() queryLinks() returns an array of PropertyLinkInfo objects containing information about properties on this component which are linked to properties on this or other components.
PropertyLinkInfo[]	queryLinks(String property) queryLinks() returns an array of PropertyLinkInfo objects containing information about the links to the specified property.
void	refresh(ModelInterface model) Updates the view based on updates in the model.
void	removeAllLinks() removeAllLinks() removes all the links on this component.
void	removeInterfaceTraps(ModelInterface model)
void	removeLink(String property, ComponentInterface linked_component, String linked_property) removeLink() removes a link between property on this component and source_property on source_component.
void	removePropertyChangeListener(PropertyChangeListener listener) Removes a PropertyChangeListener from the component.
void	removeVetoableChangeListener(VetoableChangeListener listener) Removes a VetoableChangeListener from the component.
void	setBackgroundColor(Color color) Sets the background color of the component.
void	setBorder(BorderInterface border) Sets the border drawn around the component.
void	setBounds(int x, int y, int width, int height)
void	setComponentDescription(String description) This method sets the description of the component.
void	setComponentSupportInfo(ComponentInterfaceSupportInfo info) Internal framework method.
void	setDefaultValues() This method sets the initial property values to their default values.
void	setEnabled(boolean enabled) setEnabled() is the set accessor method for the Enabled attribute.
void	setFocus(boolean focus) setFocus sets focus to the component or away from the component.
void	setFont(Font font) Sets the font to be used by the component for displaying text.
void	setForegroundColor(Color color) Sets the foreground color of the component.
void	setHeight(int height) This method sets the height of the component in pixels.
void	setHorizontalPosition(int horizontalPosition) This method sets the horizontal starting position of the component in pixels.
void	setLinkInfo(LinkPropertiesInfo info) Internal framework method.
void	setModelInterface(ModelInterface model) Calling setModelInterface will detach the previous model (if any) and will call attachModel to attach the model to this view.
void	setPreferredSize(Dimension preferredSize) This method allows the user to set the Dimension returned by getPreferredSize.
void	setPrePainter(PainterInterface painter) Sets the painter used to draw over the background of the component.
void	setRequiredInterfaces(Vector interfaces) The set method for the requiredInterfaces attribute.
void	setTransparent(boolean transparent) Sets whether the background of the component is filled with the backgroundColor.
void	setVerticalPosition(int verticalPosition) This method sets the vertical starting position of the component in pixels.
void	setViewInterfaceSupportInfo(ViewInterfaceSupportInfo info) Internal framework method.
void	setVisible(boolean visible) setVisible() is the set accessor method for the Visible attribute.
void	setVisualInterfaceSupportInfo(VisualInterfaceSupportInfo info) This method is not intended to be called by users.
void	setWidth(int width) This method sets the width of the component in pixels.
Font	superGetFont() This method is not intended to be used by users.
Dimension	superGetMinimumSize() This method is not intended to be used by users.
Dimension	superGetPreferredSize() This method is not intended to be used by users.
boolean	superIsEnabled() This method is not intended to be used by users.
boolean	superIsVisible() This method is not intended to be used by users.
void	superPaint(Graphics g) This method is not intended to be used by users.
void	superSetBounds(int x, int y, int width, int height) This method is not intended to be used by users.
void	superSetEnabled(boolean enabled) This method is not intended to be used by users.
void	superSetFont(Font font) This method is not intended to be used by users.
void	superSetVisible(boolean visible) This method is not intended to be used by users.
void	superUpdate(Graphics g) This method is not intended to be used by users.
boolean	supportsListenerInterface(Class listenerInterface) Determines if a listenerInterface class is supported by the implementing class.
boolean	supportsRequiredInterfaces(ModelInterface model) Checks a potential model to this view to see if it supports the required interfaces of this view.
void	trapInterfaceEvents(ModelInterface model)
void	update(Graphics g)
void	validateObject()

Methods inherited from class java.applet.Applet

destroy, getAccessibleContext, getAppletContext, getAppletInfo, getAudioClip, getAudioClip, getCodeBase, getDocumentBase, getImage, getImage, getLocale, getParameter, getParameterInfo, init, isActive, newAudioClip, play, play, resize, resize, setStub, showStatus, start, stop

Methods inherited from class java.awt.Panel

addNotify

Methods inherited from class java.awt.Container

add, add, add, add, add, addContainerListener, addImpl, addPropertyChangeListener, applyComponentOrientation, areFocusTraversalKeysSet, countComponents, deliverEvent, doLayout, findComponentAt, findComponentAt, getAlignmentX, getAlignmentY, getComponent, getComponentAt, getComponentAt, getComponentCount, getComponents, getContainerListeners, getFocusTraversalKeys, getFocusTraversalPolicy, getInsets, getLayout, getListeners, getMaximumSize, insets, invalidate, isAncestorOf, isFocusCycleRoot, isFocusCycleRoot, isFocusTraversalPolicySet, layout, list, list, locate, minimumSize, paintComponents, paramString, preferredSize, print, printComponents, processContainerEvent, processEvent, remove, remove, removeAll, removeContainerListener, removeNotify, 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, contains, createImage, createImage, createVolatileImage, createVolatileImage, disable, disableEvents, dispatchEvent, enable, enable, enableEvents, enableInputMethods, firePropertyChange, firePropertyChange, getBackground, getBounds, getBounds, getColorModel, getComponentListeners, getComponentOrientation, getCursor, getDropTarget, getFocusCycleRootAncestor, getFocusListeners, getFocusTraversalKeysEnabled, getFontMetrics, getForeground, getGraphics, getGraphicsConfiguration, getHierarchyBoundsListeners, getHierarchyListeners, getIgnoreRepaint, getInputContext, getInputMethodListeners, getInputMethodRequests, getKeyListeners, getLocation, getLocation, getLocationOnScreen, getMouseListeners, getMouseMotionListeners, getMouseWheelListeners, getName, getParent, getPeer, getPropertyChangeListeners, getPropertyChangeListeners, getSize, getSize, getToolkit, getTreeLock, getX, getY, gotFocus, handleEvent, hasFocus, hide, imageUpdate, inside, isBackgroundSet, isCursorSet, isDisplayable, isDoubleBuffered, isFocusable, isFocusOwner, isFocusTraversable, isFontSet, isForegroundSet, isLightweight, isOpaque, isShowing, isValid, keyDown, keyUp, list, list, list, location, lostFocus, mouseDown, mouseDrag, mouseEnter, mouseExit, mouseMove, mouseUp, move, nextFocus, paintAll, postEvent, prepareImage, prepareImage, printAll, processComponentEvent, processFocusEvent, processHierarchyBoundsEvent, processHierarchyEvent, processInputMethodEvent, processKeyEvent, processMouseEvent, processMouseMotionEvent, processMouseWheelEvent, remove, removeComponentListener, removeFocusListener, removeHierarchyBoundsListener, removeHierarchyListener, removeInputMethodListener, removeKeyListener, removeMouseListener, removeMouseMotionListener, removeMouseWheelListener, removePropertyChangeListener, repaint, repaint, repaint, repaint, requestFocus, requestFocus, requestFocusInWindow, requestFocusInWindow, reshape, setBackground, setBounds, setComponentOrientation, setCursor, setDropTarget, setFocusable, setFocusTraversalKeysEnabled, setForeground, setIgnoreRepaint, setLocale, setLocation, setLocation, setName, setSize, setSize, show, show, size, toString, transferFocus, transferFocusUpCycle

Methods inherited from class java.lang.Object

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

Constructor Detail

AppletVisualComponent

public AppletVisualComponent()

Method Detail

getExtendedBeanInfo

public static ExtendedBeanInfo getExtendedBeanInfo()

Returns information used by the com.sas.beans.Introspector to augment the automatically introspected information about the component.

clone

public Object clone()
             throws CloneNotSupportedException

Return a clone of the object.

Overrides:

clone in class Object

Returns:

a clone of the object.

Throws:

CloneNotSupportedException - if the model attached to the component being cloned will not allow the clone to attach.

trapInterfaceEvents

public void trapInterfaceEvents(ModelInterface model)

Specified by:

trapInterfaceEvents in interface ViewInterface

See Also:

ViewInterface.trapInterfaceEvents(com.sas.ModelInterface)

removeInterfaceTraps

public void removeInterfaceTraps(ModelInterface model)

Specified by:

removeInterfaceTraps in interface ViewInterface

See Also:

ViewInterface.removeInterfaceTraps(com.sas.ModelInterface)

getRequiredInterfaces

public Vector getRequiredInterfaces()

Description copied from interface: ViewInterface

The get method for the requiredInterfaces attribute. Retrieves the current value of the RequiredInterfaces atttribute. This information contains an array for each required interface.

Specified by:

getRequiredInterfaces in interface ViewInterface

See Also:

ViewInterface.getRequiredInterfaces()

setRequiredInterfaces

public void setRequiredInterfaces(Vector interfaces)

Description copied from interface: ViewInterface

The set method for the requiredInterfaces attribute. Sets the current value of the RequiredInterfaces attribute.

Specified by:

setRequiredInterfaces in interface ViewInterface

See Also:

ViewInterface.setRequiredInterfaces(java.util.Vector)

attachModel

public void attachModel(ModelInterface model)

Description copied from interface: ViewInterface

Attaches the specified model to this view. Calls attachView on the model to notify it of the attach request. Throws a run time ComponentException if the model denies the attach request. Calls trapInterfaceEvents on the view to set up the appropriate event handlers in the view for attribute changed events from the model. attachModel will be called once for the model specified in the setModel method. It is the responsibility of the views to maintain interface handles to multiple models; one interface handle will be set in the attachModel call and cleared in detachModel. Therefore, the interface handle will always point to the last model attached to. Throws a run time ComponentException if the specified model does not support the required interface on the view. Calls refresh, passing the model interface, on the view after successful completion to allow the view to update itself.

Specified by:

attachModel in interface ViewInterface

See Also:

ViewInterface.attachModel(com.sas.ModelInterface)

detachModel

public void detachModel(ModelInterface model)

Description copied from interface: ViewInterface

Detaches the specified model from this view. Calls detachView on the model to notify it of the attach request. Calls removeInterfaceTraps on the view to remove the appropriate event handlers in the view for attribute changed events from the model. Calls refresh, passing null for the model interface, on the view after successful completion to allow the view to clear itself.

Specified by:

detachModel in interface ViewInterface

See Also:

ViewInterface.detachModel(com.sas.ModelInterface)

refresh

public void refresh(ModelInterface model)

Description copied from interface: ViewInterface

Updates the view based on updates in the model. Called by attachModel upon a successful attach to give the view a chance to update itself. Views should override this method to perform whatever updates are necessary after a model update.

Specified by:

refresh in interface ViewInterface

See Also:

ViewInterface.refresh(com.sas.ModelInterface)

supportsRequiredInterfaces

public boolean supportsRequiredInterfaces(ModelInterface model)

Description copied from interface: ViewInterface

Checks a potential model to this view to see if it supports the required interfaces of this view.

Specified by:

supportsRequiredInterfaces in interface ViewInterface

See Also:

ViewInterface.supportsRequiredInterfaces(com.sas.ModelInterface)

getModelInterface

public ModelInterface getModelInterface()

Specified by:

getModelInterface in interface ViewInterface

See Also:

ViewInterface.getModelInterface()

setModelInterface

public void setModelInterface(ModelInterface model)

Description copied from interface: ViewInterface

Calling setModelInterface will detach the previous model (if any) and will call attachModel to attach the model to this view. Sends a propertyChange event for the model property

Specified by:

setModelInterface in interface ViewInterface

See Also:

ViewInterface.setModelInterface(com.sas.ModelInterface)

getViewInterfaceSupportInfo

public ViewInterfaceSupportInfo getViewInterfaceSupportInfo()

Internal framework method. Not intended to be called by component users.

Specified by:

getViewInterfaceSupportInfo in interface ViewInterface

See Also:

ViewInterface.getViewInterfaceSupportInfo()

setViewInterfaceSupportInfo

public void setViewInterfaceSupportInfo(ViewInterfaceSupportInfo info)

Internal framework method. Not intended to be called by component users.

Specified by:

setViewInterfaceSupportInfo in interface ViewInterface

See Also:

ViewInterface.setViewInterfaceSupportInfo(com.sas.ViewInterfaceSupportInfo)

attachView

public boolean attachView()

Description copied from interface: ModelInterface

attachView is called on the model during an attachModel call on the view. The attachView method serves as a hook for the model to receive notification that a view is attaching to it. The model can deny the attach request by returning false, in which case the attachModel request on the view will fail.

Specified by:

attachView in interface ModelInterface

See Also:

ModelInterface.attachView()

detachView

public void detachView()

Description copied from interface: ModelInterface

detachView is called on the model during an detachModel call on the view. The detachView method serves as a hook for the model to receive notification that a view is detaching from it.

Specified by:

detachView in interface ModelInterface

See Also:

ModelInterface.detachView()

addLink

public void addLink(String property,
                    ComponentInterface linked_component,
                    String linked_property)

Description copied from interface: LinkPropertiesInterface

addLink() adds a link between property on this component and source_property on source_component. The value of source_component.source_property will be read and set on property when addLink() is called. Whenever the value of source_component.source_property changes in the future, the value of this.property will be updated.

Adding a link that already exists does nothing.

Specified by:

addLink in interface LinkPropertiesInterface

See Also:

LinkPropertiesInterface.addLink(java.lang.String, com.sas.ComponentInterface, java.lang.String)

removeLink

public void removeLink(String property,
                       ComponentInterface linked_component,
                       String linked_property)

Description copied from interface: LinkPropertiesInterface

removeLink() removes a link between property on this component and source_property on source_component.

Specified by:

removeLink in interface LinkPropertiesInterface

See Also:

LinkPropertiesInterface.removeLink(java.lang.String, com.sas.ComponentInterface, java.lang.String)

removeAllLinks

public void removeAllLinks()

Description copied from interface: LinkPropertiesInterface

removeAllLinks() removes all the links on this component.

Specified by:

removeAllLinks in interface LinkPropertiesInterface

See Also:

LinkPropertiesInterface.removeAllLinks()

queryLinks

public PropertyLinkInfo[] queryLinks(String property)

Description copied from interface: LinkPropertiesInterface

queryLinks() returns an array of PropertyLinkInfo objects containing information about the links to the specified property.

Specified by:

queryLinks in interface LinkPropertiesInterface

See Also:

LinkPropertiesInterface.queryLinks(java.lang.String)

queryLinks

public PropertyLinkInfo[] queryLinks()

Description copied from interface: LinkPropertiesInterface

queryLinks() returns an array of PropertyLinkInfo objects containing information about properties on this component which are linked to properties on this or other components.

Specified by:

queryLinks in interface LinkPropertiesInterface

See Also:

LinkPropertiesInterface.queryLinks(java.lang.String)

isLinked

public boolean isLinked(String property,
                        ComponentInterface linked_component,
                        String linked_property)

Description copied from interface: LinkPropertiesInterface

isLinked() determines if property on this component is linked to source_property on source_component.

Specified by:

isLinked in interface LinkPropertiesInterface

See Also:

LinkPropertiesInterface.queryLinks(java.lang.String)

getLinkInfo

public LinkPropertiesInfo getLinkInfo()

Internal framework method. Not intended to be called by component users.

Specified by:

getLinkInfo in interface LinkPropertiesInterface

Following copied from interface: com.sas.LinkPropertiesInterface

See Also:

LinkPropertiesInterfaceSupport

setLinkInfo

public void setLinkInfo(LinkPropertiesInfo info)

Internal framework method. Not intended to be called by component users.

Specified by:

setLinkInfo in interface LinkPropertiesInterface

Following copied from interface: com.sas.LinkPropertiesInterface

See Also:

LinkPropertiesInterfaceSupport

addPropertyChangeListener

public void addPropertyChangeListener(PropertyChangeListener listener)

Description copied from interface: ComponentInterface

Adds a PropertyChangeListener to the component.

Specified by:

addPropertyChangeListener in interface ComponentInterface

Overrides:

addPropertyChangeListener in class Container

See Also:

ComponentInterface.addPropertyChangeListener(java.beans.PropertyChangeListener)

removePropertyChangeListener

public void removePropertyChangeListener(PropertyChangeListener listener)

Description copied from interface: ComponentInterface

Removes a PropertyChangeListener from the component.

Specified by:

removePropertyChangeListener in interface ComponentInterface

Overrides:

removePropertyChangeListener in class Component

See Also:

ComponentInterface.removePropertyChangeListener(java.beans.PropertyChangeListener)

firePropertyChange

public void firePropertyChange(String propertyName,
                               Object oldValue,
                               Object newValue)

Description copied from interface: ComponentInterface

Report a bound property update to any registered listeners. This method returns immediately without any action if there are no registered PropertyChangeEvent listeners. No event is fired if old and new are equal and non-null. This method corresponds to the java.beans.PropertyChangeSupport firePropertyChange method, which we cannot call directly since we have our own com.sas.beans.PropertyChangeEvent.

Specified by:

firePropertyChange in interface ComponentInterface

Overrides:

firePropertyChange in class Component

See Also:

ComponentInterface.firePropertyChange(java.lang.String, java.lang.Object, java.lang.Object)

firePropertyChange

public void firePropertyChange(PropertyChangeEvent propertyChangeEvent)

Description copied from interface: ComponentInterface

Report a bound property update to any registered listeners. This method is provided to allow the user to pass in their existing property change event; usually the other firePropertyChange method will be used which constructs a property change event. Before constructing a PropertyChangeEvent, you should test if there are any PropertyChangeEvent listeners and skip allocating and firing the event if there are no listeners.

Specified by:

firePropertyChange in interface ComponentInterface

See Also:

ComponentInterface.firePropertyChange(java.lang.String, java.lang.Object, java.lang.Object)

propertyChange

public void propertyChange(PropertyChangeEvent e)

Handles any property links on this component from the source component.

Specified by:

propertyChange in interface PropertyChangeListener

See Also:

PropertyChangeListener.propertyChange(java.beans.PropertyChangeEvent)

getComponentDescription

public String getComponentDescription()

Description copied from interface: ComponentInterface

This method returns the description of the component.

Specified by:

getComponentDescription in interface ComponentInterface

See Also:

ComponentInterface.getComponentDescription()

setComponentDescription

public void setComponentDescription(String description)

Description copied from interface: ComponentInterface

This method sets the description of the component.

Application writers may want to set unique componentDescriptions on components so that they can be distinquished properly in a testing environment.

Specified by:

setComponentDescription in interface ComponentInterface

See Also:

ComponentInterface.setComponentDescription(java.lang.String)

isDesignTime

public boolean isDesignTime()

Description copied from interface: ComponentInterface

This method returns whether the component is in design mode or in run mode. Typically, a development environment for JavaBeans will set the designTime property to true while the component is being manipulated inside the development environment.

ComponentInterface.isDesignTime should be used instead of java.beans.Beans.isDesignTime since java.beans.Beans.isDesignTime is not thread safe and changes the status of all JavaBeans at the same time.

Specified by:

isDesignTime in interface ComponentInterface

See Also:

ComponentInterface.isDesignTime()

dumpComponent

public void dumpComponent()

Description copied from interface: ComponentInterface

This method prints debugging information about the component. The value of all of the component's properties is printed. dumpComponent may be overridden by subclasses to provide additional information about component.

Specified by:

dumpComponent in interface ComponentInterface

See Also:

ComponentInterface.dumpComponent()

addVetoableChangeListener

public void addVetoableChangeListener(VetoableChangeListener listener)

Description copied from interface: ComponentInterface

Adds a VetoableChangeListener to the component.

Specified by:

addVetoableChangeListener in interface ComponentInterface

See Also:

ComponentInterface.addVetoableChangeListener(java.beans.VetoableChangeListener)

removeVetoableChangeListener

public void removeVetoableChangeListener(VetoableChangeListener listener)

Description copied from interface: ComponentInterface

Removes a VetoableChangeListener from the component.

Specified by:

removeVetoableChangeListener in interface ComponentInterface

See Also:

ComponentInterface.removeVetoableChangeListener(java.beans.VetoableChangeListener)

fireVetoableChange

public void fireVetoableChange(String propertyName,
                               Object oldValue,
                               Object newValue)
                        throws PropertyVetoException

Description copied from interface: ComponentInterface

Report a constrained property update to any registered listeners. No event is fired if old and new are equal and non-null. This method calls the java.beans.VetoableChangeSupport fireVetoableChange method. Throws a java.beans.PropertyVetoException.

Specified by:

fireVetoableChange in interface ComponentInterface

Throws:

PropertyVetoException - The listener vetoed the set of this constrained property

See Also:

ComponentInterface.fireVetoableChange(java.lang.String, java.lang.Object, java.lang.Object)

anyPropertyChangeListeners

public boolean anyPropertyChangeListeners()

Return true if there are any PropertyChangeEvent listeners. If false, you property set methods can skip any additional logic for sending PropertyChangeEvents. Note, there is no equivalent test for vetoable PropertyChangeListeners.

Specified by:

anyPropertyChangeListeners in interface ComponentInterface

Returns:

true if there are any property change listeners.

initialize

public void initialize()

Description copied from interface: ComponentInterface

The initialize() method was designed to be a synchronization point after the constructor for the object has completed and a number of methods have been called on the component. This allows components with "expensive" set method calls to delay processing until all the sets have occurred.

initialize() should be called on a component after is it constructed :

     ListBox listBox = new ListBox();
     listBox.initialize();
     container.add( listBox );
 

Overriding initialize is now discouraged since it is generally better to override setDefaultValues and readObject to perform initialization.

By default (in the ComponentInterface implementation), initialize() does nothing. However, various components override initialize() to perform operations, and it should be called.

Although use of initialize() is now discouraged, initialize() is also called by the validateObject method after a component is deserialized. This allows components which need processing during creation and deserialization to have a common place to perform operations. Adding event handlers to subcomponents is a typical use of the initialize method.

Specified by:

initialize in interface ComponentInterface

See Also:

ComponentInterface.initialize()

initializeComponent

public void initializeComponent()

Description copied from interface: ComponentInterface

Called by the default constructor. initializeComponent calls setDefaultValues and then sets the designTime property on the component based on com.sas.Component.beansIsDesignTime().

Specified by:

initializeComponent in interface ComponentInterface

See Also:

ComponentInterface.initializeComponent()

setDefaultValues

public void setDefaultValues()

Description copied from interface: ComponentInterface

This method sets the initial property values to their default values. It is called by initializeComponent. Subclasses of the Component class or classes that implement the ComponentInterface should override setDefaultValues to perform their initialization.

Note that the designTime property is not initialized when setDefaultValues is called, so initialization which depends on the value of designTime should take place in initializeComponent.

Specified by:

setDefaultValues in interface ComponentInterface

See Also:

ComponentInterface.setDefaultValues()

validateObject

public void validateObject()

Specified by:

validateObject in interface ObjectInputValidation

See Also:

ComponentInterfaceSupport.validateObject(com.sas.ComponentInterface)

getComponentSupportInfo

public ComponentInterfaceSupportInfo getComponentSupportInfo(boolean createIfNecessary)

Internal framework method. Not intended to be called by component users.

Specified by:

getComponentSupportInfo in interface ComponentInterface

Following copied from interface: com.sas.ComponentInterface

Parameters:

createIfNecessary - Whether to create the ComponentInterfaceSupportInfo object if it does not already exist.

Returns:

An instance of ComponentInterfaceSupportInfo holding the information used by the ComponentSupport class to implement the ComponentInterface.

setComponentSupportInfo

public void setComponentSupportInfo(ComponentInterfaceSupportInfo info)

Internal framework method. Not intended to be called by component users.

Specified by:

setComponentSupportInfo in interface ComponentInterface

Following copied from interface: com.sas.ComponentInterface

Parameters:

info - An instance of ComponentInterfaceSupportInfo holding the information used by the ComponentSupport class to implement the ComponentInterface.

supportsListenerInterface

public boolean supportsListenerInterface(Class listenerInterface)

Description copied from interface: MultipleValueEventSourceInterface

Determines if a listenerInterface class is supported by the implementing class.

Specified by:

supportsListenerInterface in interface MultipleValueEventSourceInterface

See Also:

MultipleValueEventSourceInterfaceSupport.supportsListenerInterface(java.lang.Object, java.lang.Class)

getEventMethod

public Method getEventMethod(Method listenerMethod)

Description copied from interface: MultipleValueEventSourceInterface

Get the method used to check the value of the event.

Specified by:

getEventMethod in interface MultipleValueEventSourceInterface

See Also:

MultipleValueEventSourceInterfaceSupport.getEventMethod(java.lang.Object, java.lang.reflect.Method)

getEventValues

public String[] getEventValues(Method listenerMethod)

Description copied from interface: MultipleValueEventSourceInterface

Get the possible values for the listenerInterface method the event is sent to.

Specified by:

getEventValues in interface MultipleValueEventSourceInterface

See Also:

MultipleValueEventSourceInterfaceSupport.getEventValues(java.lang.Object, java.lang.reflect.Method)

computePreferredSize

public Dimension computePreferredSize()

Description copied from interface: VisualInterface

The default implementation of this method calls super.getPreferredSize(). This method should be overridden (instead of getPreferredSize) in components which wish to change their preferred size, so that setPreferredSize can work.

This method should not be called directly since it is called from getPreferredSize when setPreferredSize has not been called with a non-null value.

Specified by:

computePreferredSize in interface VisualInterface

See Also:

VisualInterface.computePreferredSize()

getPreferredSize

public Dimension getPreferredSize()

Specified by:

getPreferredSize in interface VisualInterface

Overrides:

getPreferredSize in class Container

See Also:

VisualInterface.getPreferredSize()

setPreferredSize

public void setPreferredSize(Dimension preferredSize)

Description copied from interface: VisualInterface

This method allows the user to set the Dimension returned by getPreferredSize. Passing in null indicates that the superclass getPreferredSize should be called.

Specified by:

setPreferredSize in interface VisualInterface

See Also:

VisualInterface.setPreferredSize(java.awt.Dimension)

getPrePainter

public PainterInterface getPrePainter()

Description copied from interface: VisualInterface

Returns the painter used to draw over the background of the component.

Specified by:

getPrePainter in interface VisualInterface

See Also:

VisualInterface.getPrePainter()

setPrePainter

public void setPrePainter(PainterInterface painter)

Description copied from interface: VisualInterface

Sets the painter used to draw over the background of the component.

Specified by:

setPrePainter in interface VisualInterface

See Also:

VisualInterface.setPrePainter(com.sas.visuals.PainterInterface)

setBounds

public void setBounds(int x,
                      int y,
                      int width,
                      int height)

Specified by:

setBounds in interface VisualInterface

Overrides:

setBounds in class Component

See Also:

VisualInterface.setBounds(int, int, int, int)

getForegroundColor

public Color getForegroundColor()

Description copied from interface: VisualInterface

Returns the foreground color of the component.

If you override getForegroundColor, users which treat the component as a java.awt.Component by calling getForeground will not get your behavior changes. So, it would be advisable to override getForeground instead.

Specified by:

getForegroundColor in interface VisualInterface

See Also:

VisualInterface.getForegroundColor()

setForegroundColor

public void setForegroundColor(Color color)

Description copied from interface: VisualInterface

Sets the foreground color of the component.

If you override setForegroundColor, users which treat the component as a java.awt.Component by calling setForeground will not get your behavior changes. So, it would be advisable to override setForeground instead.

Specified by:

setForegroundColor in interface VisualInterface

See Also:

VisualInterface.setForegroundColor(java.awt.Color)

getBackgroundColor

public Color getBackgroundColor()

Description copied from interface: VisualInterface

Returns the background color of the component.

If you override getBackgroundColor, users which treat the component as a java.awt.Component by calling getBackground will not get your behavior changes. So, it would be advisable to override getBackground instead.

Specified by:

getBackgroundColor in interface VisualInterface

See Also:

VisualInterface.getBackgroundColor()

setBackgroundColor

public void setBackgroundColor(Color color)

Description copied from interface: VisualInterface

Sets the background color of the component.

If you override setBackgroundColor, users which treat the component as a java.awt.Component by calling setBackground will not get your behavior changes. So, it would be advisable to override setBackground instead.

Specified by:

setBackgroundColor in interface VisualInterface

See Also:

VisualInterface.setBackgroundColor(java.awt.Color)

getFont

public Font getFont()

Description copied from interface: VisualInterface

Returns the font used by the component to display text.

Specified by:

getFont in interface VisualInterface

Overrides:

getFont in class Component

See Also:

VisualInterface.getFont()

setFont

public void setFont(Font font)

Description copied from interface: VisualInterface

Sets the font to be used by the component for displaying text. Note that some very complex components may use additional or alternate fonts to display text.

Specified by:

setFont in interface VisualInterface

Overrides:

setFont in class Container

See Also:

VisualInterface.setFont(java.awt.Font)

getWidth

public int getWidth()

Description copied from interface: VisualInterface

This method returns the width of the component in pixels.

Specified by:

getWidth in interface VisualInterface

Overrides:

getWidth in class Component

See Also:

VisualInterface.getWidth()

setWidth

public void setWidth(int width)

Description copied from interface: VisualInterface

This method sets the width of the component in pixels. The component is responsible for resizing itself to the new size after the change is made.

Specified by:

setWidth in interface VisualInterface

See Also:

VisualInterface.setWidth(int)

getHeight

public int getHeight()

Description copied from interface: VisualInterface

This method returns the vertical size of the component in pixels.

Specified by:

getHeight in interface VisualInterface

Overrides:

getHeight in class Component

See Also:

VisualInterface.getHeight()

setHeight

public void setHeight(int height)

Description copied from interface: VisualInterface

This method sets the height of the component in pixels. The component is responsible for resizing itself to the new size after the change is made.

Specified by:

setHeight in interface VisualInterface

See Also:

VisualInterface.setHeight(int)

getHorizontalPosition

public int getHorizontalPosition()

Description copied from interface: VisualInterface

This method returns the horizontal starting position of the component in pixels.

Specified by:

getHorizontalPosition in interface VisualInterface

See Also:

VisualInterface.getHorizontalPosition()

setHorizontalPosition

public void setHorizontalPosition(int horizontalPosition)

Description copied from interface: VisualInterface

This method sets the horizontal starting position of the component in pixels. The component is responsible for moving itself to the new location after the change is made.

Specified by:

setHorizontalPosition in interface VisualInterface

See Also:

VisualInterface.setHorizontalPosition(int)

getVerticalPosition

public int getVerticalPosition()

Description copied from interface: VisualInterface

This method returns the vertical starting position of the component in pixels.

Specified by:

getVerticalPosition in interface VisualInterface

See Also:

VisualInterface.getVerticalPosition()

setVerticalPosition

public void setVerticalPosition(int verticalPosition)

Description copied from interface: VisualInterface

This method sets the vertical starting position of the component in pixels. The component is responsible for moving itself to the new location after the change is made.

Specified by:

setVerticalPosition in interface VisualInterface

See Also:

VisualInterface.setVerticalPosition(int)

getBorder

public BorderInterface getBorder()

Description copied from interface: VisualInterface

Returns the border drawn around the component.

Specified by:

getBorder in interface VisualInterface

See Also:

VisualInterface.getBorder()

setBorder

public void setBorder(BorderInterface border)

Description copied from interface: VisualInterface

Sets the border drawn around the component.

Specified by:

setBorder in interface VisualInterface

See Also:

VisualInterface.setBorder(com.sas.visuals.BorderInterface)

isEnabled

public boolean isEnabled()

Description copied from interface: VisualInterface

Returns whether the component is currently enabled.

Specified by:

isEnabled in interface VisualInterface

Overrides:

isEnabled in class Component

See Also:

VisualInterface.isEnabled()

setEnabled

public void setEnabled(boolean enabled)

Description copied from interface: VisualInterface

setEnabled() is the set accessor method for the Enabled attribute. Pass in true to enable the component. Pass in false to disable the component.

Specified by:

setEnabled in interface VisualInterface

Overrides:

setEnabled in class Component

See Also:

VisualInterface.setEnabled(boolean)

isTransparent

public boolean isTransparent()

Description copied from interface: VisualInterface

Returns whether the background is not filled with the backgroundColor.

Specified by:

isTransparent in interface VisualInterface

See Also:

VisualInterface.isTransparent()

setTransparent

public void setTransparent(boolean transparent)

Description copied from interface: VisualInterface

Sets whether the background of the component is filled with the backgroundColor.

The default implementation of the VisualInterface in VisualInterfaceSupport throws a java.lang.IllegalStateException if setTransparent(true) is called on a heavyweight component.

Specified by:

setTransparent in interface VisualInterface

See Also:

VisualInterface.setTransparent(boolean)

isFocus

public boolean isFocus()

Description copied from interface: VisualInterface

isFocus returns whether the component currently has focus.

Specified by:

isFocus in interface VisualInterface

See Also:

VisualInterface.isFocus()

setFocus

public void setFocus(boolean focus)

Description copied from interface: VisualInterface

setFocus sets focus to the component or away from the component.

Specified by:

setFocus in interface VisualInterface

See Also:

VisualInterface.setFocus(boolean)

isVisible

public boolean isVisible()

Description copied from interface: VisualInterface

Returns whether the component is currently visible.

Specified by:

isVisible in interface VisualInterface

Overrides:

isVisible in class Component

See Also:

VisualInterface.isVisible()

setVisible

public void setVisible(boolean visible)

Description copied from interface: VisualInterface

setVisible() is the set accessor method for the Visible attribute. Pass in true to show the component. Pass in false to hide the component.

Specified by:

setVisible in interface VisualInterface

Overrides:

setVisible in class Component

See Also:

VisualInterface.setVisible(boolean)

getMinimumSize

public Dimension getMinimumSize()

Description copied from interface: VisualInterface

Overrides the java.awt.Component getMinimumSize method to return a minimum size of 5,5 for components which do not have a peer. For components which do have a peer, the java.awt.Component getMinimumSize method will be called.

Specified by:

getMinimumSize in interface VisualInterface

Overrides:

getMinimumSize in class Container

See Also:

VisualInterface.getMinimumSize()

getVisualInterfaceSupportInfo

public VisualInterfaceSupportInfo getVisualInterfaceSupportInfo()

Description copied from interface: VisualInterface

This method is not intended to be called by users. The VisualInterfaceSupport class uses this method.

Returns the info object which holds instance data for objects implementing the VisualInterface interface.

Specified by:

getVisualInterfaceSupportInfo in interface VisualInterface

See Also:

VisualInterface.getVisualInterfaceSupportInfo()

setVisualInterfaceSupportInfo

public void setVisualInterfaceSupportInfo(VisualInterfaceSupportInfo info)

Description copied from interface: VisualInterface

This method is not intended to be called by users. The VisualInterfaceSupport class uses this method.

Sets the info object which holds instance data for objects implementing the VisualInterface interface.

Specified by:

setVisualInterfaceSupportInfo in interface VisualInterface

See Also:

VisualInterface.setVisualInterfaceSupportInfo(com.sas.awt.VisualInterfaceSupportInfo)

update

public void update(Graphics g)

Overrides:

update in class Container

See Also:

VisualInterfaceSupport.update(com.sas.ComponentInterface, com.sas.awt.VisualInterface, java.awt.Component, java.awt.Graphics)

paint

public void paint(Graphics g)

Overrides:

paint in class Container

See Also:

VisualInterfaceSupport.paint(com.sas.ComponentInterface, com.sas.awt.VisualInterface, java.awt.Component, java.awt.Graphics)

superGetPreferredSize

public final Dimension superGetPreferredSize()

This method is not intended to be used by users. It is only used by VisualInterfaceSupport.

Calls the superclasses getPreferredSize() method. This is used to avoid an infinite recursive loop in VisualInterfaceSupport.

Specified by:

superGetPreferredSize in interface VisualInterface

See Also:

getPreferredSize()

superPaint

public final void superPaint(Graphics g)

This method is not intended to be used by users. It is only used by VisualInterfaceSupport.

Calls the superclasses paint() method. This is used to avoid an infinite recursive loop in VisualInterfaceSupport.

Specified by:

superPaint in interface VisualInterface

See Also:

paint(java.awt.Graphics)

superUpdate

public final void superUpdate(Graphics g)

This method is not intended to be used by users. It is only used by VisualInterfaceSupport.

Calls the superclasses update() method. This is used to avoid an infinite recursive loop in VisualInterfaceSupport.

Specified by:

superUpdate in interface VisualInterface

See Also:

update(java.awt.Graphics)

superSetBounds

public final void superSetBounds(int x,
                                 int y,
                                 int width,
                                 int height)

This method is not intended to be used by users. It is only used by VisualInterfaceSupport.

Calls the superclasses setBounds() method. This is used to avoid an infinite recursive loop in VisualInterfaceSupport.

Specified by:

superSetBounds in interface VisualInterface

See Also:

setBounds(int, int, int, int)

superGetMinimumSize

public final Dimension superGetMinimumSize()

This method is not intended to be used by users. It is only used by VisualInterfaceSupport.

Calls the superclasses getMinimumSize() method and returns the result. This is used to avoid an infinite recursive loop in VisualInterfaceSupport.

Specified by:

superGetMinimumSize in interface VisualInterface

Returns:

The minimum size of the component.

See Also:

getMinimumSize()

superIsVisible

public final boolean superIsVisible()

This method is not intended to be used by users. It is only used by VisualInterfaceSupport.

Calls the superclasses isVisible() method and returns the result. This is used to avoid an infinite recursive loop in VisualInterfaceSupport.

Specified by:

superIsVisible in interface VisualInterface

Returns:

Whether the component is visible.

See Also:

VisualInterface.superIsVisible()

superSetVisible

public final void superSetVisible(boolean visible)

This method is not intended to be used by users. It is only used by VisualInterfaceSupport.

Calls the superclasses setVisible() method. This is used to avoid an infinite recursive loop in VisualInterfaceSupport.

Specified by:

superSetVisible in interface VisualInterface

Parameters:

visible - Whether the component is visible.

See Also:

VisualInterface.superSetVisible(boolean)

superIsEnabled

public final boolean superIsEnabled()

This method is not intended to be used by users. It is only used by VisualInterfaceSupport.

Calls the superclasses isEnabled() method and returns the result. This is used to avoid an infinite recursive loop in VisualInterfaceSupport.

Specified by:

superIsEnabled in interface VisualInterface

Returns:

Whether the component is enabled.

See Also:

VisualInterface.superIsEnabled()

superSetEnabled

public void superSetEnabled(boolean enabled)

This method is not intended to be used by users. It is only used by VisualInterfaceSupport.

Calls the superclasses setEnabled() method. This is used to avoid an infinite recursive loop in VisualInterfaceSupport.

Specified by:

superSetEnabled in interface VisualInterface

See Also:

VisualInterface.superSetEnabled(boolean)

superGetFont

public final Font superGetFont()

This method is not intended to be used by users. It is only used by VisualInterfaceSupport.

Calls the superclasses getFont() method and returns the result. This is used to avoid an infinite recursive loop in VisualInterfaceSupport.

Specified by:

superGetFont in interface VisualInterface

Returns:

The components Font.

See Also:

VisualInterface.superGetFont()

superSetFont

public void superSetFont(Font font)

This method is not intended to be used by users. It is only used by VisualInterfaceSupport.

Calls the superclasses setFont() method. This is used to avoid an infinite recursive loop in VisualInterfaceSupport.

Specified by:

superSetFont in interface VisualInterface

See Also:

VisualInterface.superSetEnabled(boolean)