com.altair.hwm.beans.hm
Class PmgrExec

java.lang.Object
  java.awt.Component
      java.awt.Container
          javax.swing.JComponent
              javax.swing.AbstractButton
                  javax.swing.JButton
                      com.altair.hwm.beans.hm.PmgrExec

All Implemented Interfaces:

HWMEventListener, IHWMControl, java.awt.event.ActionListener, java.awt.image.ImageObserver, java.awt.ItemSelectable, java.awt.MenuContainer, java.beans.PropertyChangeListener, java.io.Serializable, java.util.EventListener, javax.accessibility.Accessible, javax.swing.SwingConstants

public class PmgrExec
extends javax.swing.JButton
implements IHWMControl, HWMEventListener, java.beans.PropertyChangeListener, java.awt.event.ActionListener

Title: PmgrExec

Description: The Bean to support/invoke other executable. Company: Altair Engineering, Inc.

See Also:

Serialized Form

Nested Class Summary

Nested classes/interfaces inherited from class javax.swing.JComponent

javax.swing.JComponent.AccessibleJComponent

Field Summary

static java.lang.String	PROP_APP_PATH The property name for the Application path
static java.lang.String	PROP_APP_TYPE

Fields inherited from class javax.swing.AbstractButton

BORDER_PAINTED_CHANGED_PROPERTY, 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, MARGIN_CHANGED_PROPERTY, MNEMONIC_CHANGED_PROPERTY, 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

TOOL_TIP_TEXT_KEY, 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 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

PmgrExec()

PmgrExec(java.lang.String strText)
Creates a button with initial text only.

Method Summary

void	actionPerformed(java.awt.event.ActionEvent event) Calls a method to Start Application when the button is pressed
void	Disable() Providing "Disable" method rather than overriding java's "disable" method because of the following reasons: 1> disable is deprecated 2> It does nothing visually for some controls like button 3> setEnabled calls enable/disable in the base class once it changes the UI.
void	Enable() Providing "Enable" method rather than overriding java's "enable" method because of the following reasons: 1> enable is deprecated 2> It does nothing visually for some controls like button 3> setEnabled calls enable/disable in the base class once it changes the UI.
void	ExecuteGivenExe() Starts Application when the button is pressed
java.lang.String	GetAppPath() Returns the Application path
IHWMFrameWork	GetFrameWork() Returns the interface using which a bean can communicate directly with the HWM application.
java.lang.String	getToolTipText() Returns the tooltip for the button.
void	HWMEventCallback(HWMEvent hwmEvent) This method is called when the execution of a method succeeds
void	OnAction() Calls a method to Start an Application when the button is pressed
void	OnExit() Invoked by the HWM application when the bean is being destroyed.
void	Play() The play method needs to execute the functionaliy.
void	propertyChange(java.beans.PropertyChangeEvent evt) This method gets called when a bound property is changed.
void	readExternal(java.io.ObjectInput objInput) Read the data of the control back again and update the UI too
void	ReadProperties() Get the required properties from the datamodel and initialize self
void	Run() Invoked by the HWM application when all the beans are loaded and the application can run.
void	SaveProperties() Save the required properties in the datamodel (so that they persist)
void	SetAppPath(java.lang.String strAppPath) Sets the Application path
void	SetBeanName(java.lang.String strBeanName) Set the name of the bean (button control)
void	setEnabled(boolean bEnableState) Enables the button control.
void	SetFrameWork(IHWMFrameWork hwmFrameWork) This method is called by the HWM Application to set the interface with which a bean (button control) can communicate directly with the HWM application.
void	setPreferredSize(java.awt.Dimension dim) Set the preferred size
void	setText(java.lang.String strText) Set the text on the button
void	setToolTipText(java.lang.String strToolTip) Sets the tooltip for the button.
void	setVisible(boolean bVisibleState) Makes the button control visible or invisible.
void	writeExternal(java.io.ObjectOutput objOutput) Save the persistent properties

Methods inherited from class javax.swing.JButton

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

Methods inherited from class javax.swing.AbstractButton

addActionListener, addChangeListener, addItemListener, doClick, doClick, 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, isBorderPainted, isContentAreaFilled, isFocusPainted, isRolloverEnabled, isSelected, removeActionListener, removeChangeListener, removeItemListener, setAction, setActionCommand, setBorderPainted, setContentAreaFilled, setDisabledIcon, setDisabledSelectedIcon, setDisplayedMnemonicIndex, setFocusPainted, setHorizontalAlignment, setHorizontalTextPosition, setIcon, setIconTextGap, setLabel, setLayout, setMargin, setMnemonic, setMnemonic, setModel, setMultiClickThreshhold, setPressedIcon, setRolloverEnabled, setRolloverIcon, setRolloverSelectedIcon, setSelected, setSelectedIcon, setUI, setVerticalAlignment, setVerticalTextPosition

Methods inherited from class javax.swing.JComponent

addAncestorListener, addNotify, addVetoableChangeListener, computeVisibleRect, contains, createToolTip, disable, enable, firePropertyChange, firePropertyChange, firePropertyChange, getActionForKeyStroke, getActionMap, getAlignmentX, getAlignmentY, getAncestorListeners, getAutoscrolls, getBorder, getBounds, getClientProperty, getComponentPopupMenu, getConditionForKeyStroke, getDebugGraphicsOptions, getDefaultLocale, getFontMetrics, getGraphics, getHeight, getInheritsPopupMenu, getInputMap, getInputMap, getInputVerifier, getInsets, getInsets, getListeners, getLocation, getMaximumSize, getMinimumSize, getNextFocusableComponent, getPopupLocation, getPreferredSize, getRegisteredKeyStrokes, getRootPane, getSize, getToolTipLocation, getToolTipText, getTopLevelAncestor, getTransferHandler, getVerifyInputWhenFocusTarget, getVetoableChangeListeners, getVisibleRect, getWidth, getX, getY, grabFocus, isDoubleBuffered, isLightweightComponent, isManagingFocus, isOpaque, isOptimizedDrawingEnabled, isPaintingTile, isRequestFocusEnabled, isValidateRoot, paint, paintImmediately, paintImmediately, print, printAll, putClientProperty, registerKeyboardAction, registerKeyboardAction, removeAncestorListener, removeVetoableChangeListener, repaint, repaint, requestDefaultFocus, requestFocus, requestFocus, requestFocusInWindow, resetKeyboardActions, reshape, revalidate, scrollRectToVisible, setActionMap, setAlignmentX, setAlignmentY, setAutoscrolls, setBackground, setBorder, setComponentPopupMenu, setDebugGraphicsOptions, setDefaultLocale, setDoubleBuffered, setFocusTraversalKeys, setFont, setForeground, setInheritsPopupMenu, setInputMap, setInputVerifier, setMaximumSize, setMinimumSize, setNextFocusableComponent, setOpaque, setRequestFocusEnabled, setTransferHandler, setVerifyInputWhenFocusTarget, unregisterKeyboardAction, update

Methods inherited from class java.awt.Container

add, add, add, add, add, addContainerListener, addPropertyChangeListener, addPropertyChangeListener, applyComponentOrientation, areFocusTraversalKeysSet, countComponents, deliverEvent, doLayout, findComponentAt, findComponentAt, getComponent, getComponentAt, getComponentAt, getComponentCount, getComponents, getComponentZOrder, getContainerListeners, getFocusTraversalKeys, getFocusTraversalPolicy, getLayout, getMousePosition, insets, invalidate, isAncestorOf, isFocusCycleRoot, isFocusCycleRoot, isFocusTraversalPolicyProvider, isFocusTraversalPolicySet, layout, list, list, locate, minimumSize, paintComponents, preferredSize, printComponents, remove, remove, removeAll, removeContainerListener, setComponentZOrder, setFocusCycleRoot, setFocusTraversalPolicy, setFocusTraversalPolicyProvider, transferFocusBackward, transferFocusDownCycle, validate

Methods inherited from class java.awt.Component

action, add, addComponentListener, addFocusListener, addHierarchyBoundsListener, addHierarchyListener, addInputMethodListener, addKeyListener, addMouseListener, addMouseMotionListener, addMouseWheelListener, bounds, checkImage, checkImage, contains, createImage, createImage, createVolatileImage, createVolatileImage, dispatchEvent, enable, enableInputMethods, firePropertyChange, firePropertyChange, firePropertyChange, firePropertyChange, firePropertyChange, getBackground, getBounds, getColorModel, getComponentListeners, getComponentOrientation, getCursor, getDropTarget, getFocusCycleRootAncestor, getFocusListeners, getFocusTraversalKeysEnabled, getFont, getForeground, getGraphicsConfiguration, getHierarchyBoundsListeners, getHierarchyListeners, getIgnoreRepaint, getInputContext, getInputMethodListeners, getInputMethodRequests, getKeyListeners, getLocale, getLocation, getLocationOnScreen, getMouseListeners, getMouseMotionListeners, getMousePosition, getMouseWheelListeners, getName, getParent, getPeer, getPropertyChangeListeners, getPropertyChangeListeners, getSize, getToolkit, getTreeLock, gotFocus, handleEvent, hasFocus, hide, inside, isBackgroundSet, isCursorSet, isDisplayable, isEnabled, isFocusable, isFocusOwner, isFocusTraversable, isFontSet, isForegroundSet, isLightweight, isMaximumSizeSet, isMinimumSizeSet, isPreferredSizeSet, isShowing, isValid, isVisible, keyDown, keyUp, list, list, list, location, lostFocus, mouseDown, mouseDrag, mouseEnter, mouseExit, mouseMove, mouseUp, move, nextFocus, paintAll, postEvent, prepareImage, prepareImage, remove, removeComponentListener, removeFocusListener, removeHierarchyBoundsListener, removeHierarchyListener, removeInputMethodListener, removeKeyListener, removeMouseListener, removeMouseMotionListener, removeMouseWheelListener, removePropertyChangeListener, removePropertyChangeListener, 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

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

Field Detail

PROP_APP_PATH

public static final java.lang.String PROP_APP_PATH

The property name for the Application path

See Also:

Constant Field Values

PROP_APP_TYPE

public static final java.lang.String PROP_APP_TYPE

See Also:

Constant Field Values

Constructor Detail

PmgrExec

public PmgrExec()

PmgrExec

public PmgrExec(java.lang.String strText)

Creates a button with initial text only.

Parameters:

strText - - the text of the button.

Method Detail

setPreferredSize

public void setPreferredSize(java.awt.Dimension dim)

Set the preferred size

Overrides:

setPreferredSize in class javax.swing.JComponent

propertyChange

public void propertyChange(java.beans.PropertyChangeEvent evt)

This method gets called when a bound property is changed.

Specified by:

propertyChange in interface java.beans.PropertyChangeListener

Parameters:

evt - - A PropertyChangeEvent object describing the event source and the property that has changed.

OnAction

public void OnAction()

Calls a method to Start an Application when the button is pressed

actionPerformed

public void actionPerformed(java.awt.event.ActionEvent event)

Calls a method to Start Application when the button is pressed

Specified by:

actionPerformed in interface java.awt.event.ActionListener

Parameters:

event - - The action event object (See Java docs for help)

ExecuteGivenExe

public void ExecuteGivenExe()
                     throws java.lang.Exception

Starts Application when the button is pressed

Throws:

java.lang.Exception

setEnabled

public void setEnabled(boolean bEnableState)

Enables the button control. When the button control is disabled values cannot be typed into its field (if it is editable).

Overrides:

setEnabled in class javax.swing.AbstractButton

Parameters:

bEnableState - - a boolean value, where true enables the component and false disables it

setVisible

public void setVisible(boolean bVisibleState)

Makes the button control visible or invisible.

Overrides:

setVisible in class javax.swing.JComponent

Parameters:

bVisibleState - - true to make the component visible

Enable

public void Enable()

Providing "Enable" method rather than overriding java's "enable" method because of the following reasons: 1> enable is deprecated 2> It does nothing visually for some controls like button 3> setEnabled calls enable/disable in the base class once it changes the UI. So overriding enable or disable and then invoking setEnabled will lead to a loop where this class's enable/disable will call setEnabled on the super class and that would in turn call enable/disable in this class.

Disable

public void Disable()

Providing "Disable" method rather than overriding java's "disable" method because of the following reasons: 1> disable is deprecated 2> It does nothing visually for some controls like button 3> setEnabled calls enable/disable in the base class once it changes the UI. So overriding enable or disable and then invoking setEnabled will lead to a loop where this class's enable/disable will call setEnabled on the super class and that would in turn call enable/disable in this class.

setText

public void setText(java.lang.String strText)

Set the text on the button

Overrides:

setText in class javax.swing.AbstractButton

Parameters:

strText - The text to set on the button

setToolTipText

public void setToolTipText(java.lang.String strToolTip)

Sets the tooltip for the button. The reason we override this method is that if there is no tooltip to show, then the tooltip should be null. But the property panel will set an empty string instead of null. If the tooltip is an empty string, a black dot is shown. To avoid this problem, we set the tooltip text to null if there is no tooltip to be shown.

Overrides:

setToolTipText in class javax.swing.JComponent

Parameters:

strToolTip - Tooltip for the button

getToolTipText

public java.lang.String getToolTipText()

Returns the tooltip for the button. The reason we override this method is that if there is no tooltip to show, then the tooltip will be null. But if it is null, it will not show up in the properties.

Overrides:

getToolTipText in class javax.swing.JComponent

Returns:

String Tooltip for the button

SetAppPath

public void SetAppPath(java.lang.String strAppPath)

Sets the Application path

Parameters:

strAppPath - The path name to Application path

GetAppPath

public java.lang.String GetAppPath()

Returns the Application path

Returns:

String - The path name to the Application

SetFrameWork

public void SetFrameWork(IHWMFrameWork hwmFrameWork)

This method is called by the HWM Application to set the interface with which a bean (button control) can communicate directly with the HWM application.

Specified by:

SetFrameWork in interface IHWMControl

Parameters:

hwmFrameWork - The interface with which a bean can communicate with the HWM application.

GetFrameWork

public IHWMFrameWork GetFrameWork()

Returns the interface using which a bean can communicate directly with the HWM application.

Returns:

IHWMFrameWork The interface with which a bean (button control) can communicate with the HWM application.

SetBeanName

public void SetBeanName(java.lang.String strBeanName)

Set the name of the bean (button control)

Specified by:

SetBeanName in interface IHWMControl

Parameters:

strBeanName - The name of this bean as the framework knows it to be. Will be useful, if the bean chooses to scope its data in the datamodel - especially if multiple instances of the same bean appear in the process

writeExternal

public void writeExternal(java.io.ObjectOutput objOutput)
                   throws java.io.IOException

Save the persistent properties

Parameters:

objOutput - The stream to which data will be written

Throws:

java.io.IOException

readExternal

public void readExternal(java.io.ObjectInput objInput)
                  throws java.io.IOException,
                         java.lang.ClassNotFoundException

Read the data of the control back again and update the UI too

Parameters:

objInput - ObjectInput stream from which the properties are read

Throws:

java.io.IOException

java.lang.ClassNotFoundException

HWMEventCallback

public void HWMEventCallback(HWMEvent hwmEvent)

This method is called when the execution of a method succeeds

Specified by:

HWMEventCallback in interface HWMEventListener

Parameters:

hwmEvent - The event object that contains the event information

SaveProperties

public void SaveProperties()

Save the required properties in the datamodel (so that they persist)

ReadProperties

public void ReadProperties()

Get the required properties from the datamodel and initialize self

OnExit

public void OnExit()

Invoked by the HWM application when the bean is being destroyed. Any uninitializations to be done, can be done here by overriding this method.

Specified by:

OnExit in interface IHWMControl

Run

public void Run()

Invoked by the HWM application when all the beans are loaded and the application can run. Beans that need to perform some action once all the beans are loaded can do it here. The container will call 'Run' on all the beans that have implemented the IHWMControl. The order will be: a> First call "Run" on all the beans in pages associated with a task. Begin with the first task. b> Call 'Run' on rest of the pages (which are not associated with a task). The pages are selected based on their order of creation. c> Within a page, the beans are invoked depending on the order of their creation.

Specified by:

Run in interface IHWMControl

Play

public void Play()

The play method needs to execute the functionaliy. This may be invoked in the replay mode.

Specified by:

Play in interface IHWMControl