Oracle Data-aware Controls Reference

oracle.dacf.control.swing
Class FindPanel

java.lang.Object
  extended byjava.awt.Component
      extended byjava.awt.Container
          extended byjavax.swing.JComponent
              extended byjavax.swing.JPanel
                  extended byoracle.dacf.control.swing.FindPanel
All Implemented Interfaces:
javax.accessibility.Accessible, Control, javax.infobus.DataItemChangeListener, java.awt.image.ImageObserver, InfoBusManagerListener, java.awt.MenuContainer, java.io.Serializable

public class FindPanel
extends javax.swing.JPanel
implements Control, InfoBusManagerListener

FindPanel. A control to let specify a parameterized query and execute it. The FindPanel displays a text control and a Find button. The user can specify a value and then click the Find button to restrict the resultset to the specified value. Specify a rowset dataItemName which will be used to execute a query Specify an array of dataItemName one for each column. Usage JDialog dlg = new JDialog(); // dislay the FindPanel in this dialog FindPanel panel = new FindPanel("Find:");//Find Panel with button "Find :" dlg.getContentPane().add(panel);//also add OK and Cancel button if needed panel.setDataItemName("infobus:/oracle/Sess1/EMP"); // rowset name //column name is ENAME., paramererized query will be of form // WHERE ( ENAME LIKE S%) panel.setColumnDataItemName(new String[]{"infobus:/oracle/Sess1/EMP/ENAME"}); dlg.setSize(200,75); dlg.show();

Version:
SDK
See Also:
Serialized Form

Nested Class Summary
 
Nested classes inherited from class javax.swing.JPanel
javax.swing.JPanel.AccessibleJPanel
 
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
static int ABOVE
          position the label above the text field
static int LEFT
          position the label at LEFT
static int X_AXIS
          items (label and text field) should be laid left to right
static int Y_AXIS
          items (label and text field) should be laid top down
 
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 java.awt.image.ImageObserver
ABORT, ALLBITS, ERROR, FRAMEBITS, HEIGHT, PROPERTIES, SOMEBITS, WIDTH
 
Constructor Summary
FindPanel()
          Constructor
 
Method Summary
protected  void _applyQueryCriteriaProps(javax.infobus.ScrollableRowsetAccess rsAccess, boolean isCaseSensitive)
           
protected  javax.infobus.ScrollableRowsetAccess _getQueryCriteriaRowset()
          get query criteria rowset
protected  boolean _isDataItemNameChanged(javax.infobus.DataItem oldDataItem, javax.infobus.DataItem newDataItem)
           
protected  void _restoreDefaultCursor()
          show default cursor
protected  void _showBusyCursor()
          displays a busy cursor
 void addNavigatedListener(NavigatedListener listener)
          This method is a no-op
 void addNavigatingListener(NavigatingListener listener)
          This method is a no-op
 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 deleteAllViewCriteriaRow()
          delete all view criteria rows.
 void deleteViewCriteriaRow()
          delete the current view criteria row.
 java.awt.Cursor getBusyCursor()
          get the cursor currently used to indicated busy status
 int getColumnCount()
          number of columns used to parameterize the query
 java.lang.String[] getColumnDataItemName()
           
 java.lang.String getColumnDisplayLabel(int colIndex)
          return the column display name for a particular column
 java.lang.Object getColumnValue(int colIndex)
          return the column value for a particular column
 java.awt.Component getComponent()
          Returns the AWT component associated with this control.
 int getCurrentViewCriteriaRow()
           
 java.lang.Object getDataItem()
          Returns the InfoBus DataItem this control is bound to.
 java.lang.String getDataItemName()
          Return the data item name for the row set.
 FindItemEditor[] getFindItemEditor()
          get the custom editor for each item in the FindPanel.
 FindItemModel getFindItemModel(int column)
          get the item model for the specified column
 FindPanelUI getFindPanelUI()
          return the FindPanelUI currently in use
 boolean getHasCloseButton()
          Determine if the FindPanel has been configured to display the Close button
 boolean getHasFindButton()
          Determine if the FindPanel has been configured to display the Find button
 boolean getHasFindIcon()
          Determine if the FindPanel has been configured to display the 'Find' icon
 boolean getHasHelpButton()
          Determine if the FindPanel has been configured to display the Help button
 boolean getHasORButton()
          Determine if the FindPanel has been configured to display the 'OR>>' button
 boolean getHasRemoveAllButton()
          Determine if the FindPanel has been configured to display the 'RemoveAll'button
 boolean getHasRemoveButton()
          Determine if the FindPanel has been configured to display the 'Remove' button
 boolean getHasResetButton()
          Determine if the FindPanel has been configured to display the 'Reset' button
 boolean getHasStatusBar()
          Determine if the FindPanel has been configured to display the status bar
 javax.swing.Icon getIcon()
          Get the current 'Find' icon displayed by the FindPanel
 java.lang.String getInfoBusName()
          Returns the name of the InfoBus this control is connected to.
 javax.swing.JPanel getInnerPanel()
          get the inner panel
 int getItemDirection()
          get the current direction in which the items are arranged
 java.awt.Color getLabelBackgroundColor()
          get the current label background color
 java.awt.Font getLabelFont()
          Get the font currently used for the label.
 java.awt.Color getLabelForegroundColor()
          get the current label color
 int getLabelPosition()
          get the label position
 java.awt.Color getTextFieldBackgroundColor()
          get the textfield background color
 int getTextFieldColumnWidth()
          get the text field column width
 java.awt.Font getTextFieldFont()
          Get the font currently used for the text field.
 java.awt.Color getTextFieldForegroundColor()
          get the current textfield foreground color
 ViewCriteriaFindAction getViewCriteriaFindAction()
          obtain the ViewCriteria Find action used by the FindPanel.
 ConstrainedViewCriteriaModel getViewCriteriaModel()
          get the ViewCriteriaModel
 int getViewCriteriaRowCount()
          get the number of rows in the ViewCriteria.
 boolean isCaseSensitiveSearch()
          Return true, if the FindPanel does a case sensitive search for character data types.
 boolean isDisableAutomaticWildCardInSearch()
           
 boolean isEnabled()
          get the text field column width
 boolean isFocusValidated()
          Determines whether focus into this control causes validation to occur.
 boolean isPostAlways()
          indicates if the transaction changes are posted before re-executing the query.
 void newViewCriteriaRow()
          create a new view criteria row.
 void processNavigatedEvent(NavigatedEvent event)
          This method is a no-op
 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
 void resetFields()
          Clear all the text fields for the current view criteria row
 void rowsetCursorMoved(javax.infobus.RowsetCursorMovedEvent event)
          Indicates that the cursor for the bound RowsetAccess data item has changed rows.
 void runQuery()
          run the query
 void setBusyCursor(java.awt.Cursor busyCursor)
          Change the cursor used to indicate busy status
 void setCaseSensitiveSearch(boolean flag)
          Specify if case sensitive search is to performed for Character data types.
 void setColumnDataItemName(java.lang.String[] dataItemName)
          Specify the query column data item name.
protected  void setColumnDataItemNameInternal(java.lang.String[] dataItemName)
           
 void setColumnValue(int colIndex, java.lang.Object value)
          specify the column value for a particular column
 void setCurrentViewCriteriaRow(int row)
          sets the current view criteria row
 void setDataItemName(java.lang.String dataItemName)
          Specify the data item name for the rowset.
 void setDisableAutomaticWildCardInSearch(boolean b)
          By default, for character datatypes, wildcard character (%) is added to the search value (ex., 'Miller' is modified to LIKE 'Miller%'.
 void setEnabled(boolean enabled)
          Enable/Disable Find Panel controls.
 void setFindItemEditor(FindItemEditor[] editor)
          set the custom editor for each item in the FindPanel.
 void setFindPanelUI(FindPanelUI findPanelUI)
          customize the UI used to display the Find Panel
 void setFocusValidated(boolean focusValidated)
          This method is a no-op that is it has no effect
 void setHasCloseButton(boolean flag)
          Specify, if the FindPanel should display the 'Close' button.
 void setHasFindButton(boolean flag)
          Specify, if the FindPanel should display the 'Find' button.
 void setHasFindIcon(boolean flag)
          Specify, if the FindPanel should display the 'Find' icon.
 void setHasHelpButton(boolean flag)
          Specify, if the FindPanel should display the 'Help' button.
 void setHasORButton(boolean flag)
          Specify, if the FindPanel should display the 'OR' button.
 void setHasRemoveAllButton(boolean flag)
          Specify, if the FindPanel should display the 'RemoveAll' button.
 void setHasRemoveButton(boolean flag)
          Specify, if the FindPanel should display the 'Remove' button.
 void setHasResetButton(boolean flag)
          Specify, if the FindPanel should display the 'Reset' button.
 void setHasStatusBar(boolean flag)
          Specify, if the FindPanel should display the 'Status bar'.
 void setIcon(javax.swing.Icon icon)
          Specify the Find icon to be used.
 void setInfoBusName(java.lang.String infoBusName)
          Sets the name of the InfoBus this control is connected to.
 void setItemDirection(int direction)
          Arrange the items in one direction
 void setLabelBackgroundColor(java.awt.Color c)
          Specify the label background color
 void setLabelFont(java.awt.Font f)
          Specify the font to be used for the label.
 void setLabelForegroundColor(java.awt.Color c)
          Specify the foreground color for the label
 void setLabelPosition(int pos)
          Specify the label position relative to the text field used to display the value of the column.
 void setPostAlways(boolean bflag)
          If this flag is true, the transaction changes are posted and the query re-executed.
 void setTextFieldBackgroundColor(java.awt.Color c)
          specify the textfield background color
 void setTextFieldColumnWidth(int w)
          Specify column width for the text field
 void setTextFieldFont(java.awt.Font f)
          Specify the font to be used for the text field.
 void setTextFieldForegroundColor(java.awt.Color c)
          specify the textfield foreground color
 void setViewCriteriaFindAction(ViewCriteriaFindAction vc)
          Specify the ViewCriteriaFind action to be used by the FindPanel.
 
Methods inherited from class javax.swing.JPanel
getAccessibleContext, getUI, getUIClassID, paramString, setUI, updateUI
 
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, paintBorder, paintChildren, paintComponent, paintImmediately, paintImmediately, print, printAll, printBorder, printChildren, printComponent, processComponentKeyEvent, processKeyBinding, processKeyEvent, processMouseMotionEvent, putClientProperty, registerKeyboardAction, registerKeyboardAction, removeAncestorListener, removeNotify, 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, imageUpdate, inside, isBackgroundSet, isCursorSet, isDisplayable, 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
 

Field Detail

LEFT

public static final int LEFT
position the label at LEFT

See Also:
Constant Field Values

ABOVE

public static final int ABOVE
position the label above the text field

See Also:
Constant Field Values

X_AXIS

public static final int X_AXIS
items (label and text field) should be laid left to right

See Also:
Constant Field Values

Y_AXIS

public static final int Y_AXIS
items (label and text field) should be laid top down

See Also:
Constant Field Values
Constructor Detail

FindPanel

public FindPanel()
Constructor

Method Detail

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

setInfoBusName

public 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 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, ControlSupport.setInfoBusName(java.lang.String)

getInfoBusName

public 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:
ControlSupport.getInfoBusName()

setDataItemName

public void setDataItemName(java.lang.String dataItemName)
Specify the data item name for the rowset. The Query condition will be specified on the rowset and the query executed.

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

getDataItemName

public java.lang.String getDataItemName()
Return the data item name for the row set.

Specified by:
getDataItemName in interface Control
Returns:
data item name for the row set
See Also:
Control.getDataItem(), ControlSupport.getDataItemName()

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()

setColumnDataItemName

public void setColumnDataItemName(java.lang.String[] dataItemName)
Specify the query column data item name. This name will be use to get the Column name and the SQL type which in turn will be used to build the query condition

Parameters:
dataItemName - of the column

getColumnDataItemName

public java.lang.String[] getColumnDataItemName()
Returns:
the data item names for all the columns

setFindItemEditor

public void setFindItemEditor(FindItemEditor[] editor)
set the custom editor for each item in the FindPanel. One or more values could be null to indicate that no custom editor is used

Parameters:
editor - used for each item in the FindPanel

getFindItemEditor

public FindItemEditor[] getFindItemEditor()
get the custom editor for each item in the FindPanel. One or more values could be null to indicate that no custom editor is used

Returns:
custom editors used

setLabelPosition

public void setLabelPosition(int pos)
Specify the label position relative to the text field used to display the value of the column. Possible values are

Parameters:
pos - where should the label be relative to the textfield

getLabelPosition

public int getLabelPosition()
get the label position

Returns:
label position

setItemDirection

public void setItemDirection(int direction)
Arrange the items in one direction


getItemDirection

public int getItemDirection()
get the current direction in which the items are arranged


setHasFindButton

public void setHasFindButton(boolean flag)
Specify, if the FindPanel should display the 'Find' button. If true, the FindPanel will display the Find button.

Parameters:
flag - to specify if the Find button should be displayed

getHasFindButton

public boolean getHasFindButton()
Determine if the FindPanel has been configured to display the Find button

Returns:
true if the Find button will be displayed

setHasCloseButton

public void setHasCloseButton(boolean flag)
Specify, if the FindPanel should display the 'Close' button. If true, the FindPanel will display the Close button.

Parameters:
flag - to specify if the Find button should be displayed

getHasCloseButton

public boolean getHasCloseButton()
Determine if the FindPanel has been configured to display the Close button

Returns:
true if the Close button will be displayed

setHasHelpButton

public void setHasHelpButton(boolean flag)
Specify, if the FindPanel should display the 'Help' button. If true, the FindPanel will display the Help button.

Parameters:
flag - to specify if the Help button should be displayed

getHasHelpButton

public boolean getHasHelpButton()
Determine if the FindPanel has been configured to display the Help button

Returns:
true if the Help button will be displayed

setHasResetButton

public void setHasResetButton(boolean flag)
Specify, if the FindPanel should display the 'Reset' button. If true, the FindPanel will display the Reset button.

Parameters:
flag - to specify if the Reset button should be displayed

getHasResetButton

public boolean getHasResetButton()
Determine if the FindPanel has been configured to display the 'Reset' button

Returns:
true if the 'Reset' button will be displayed

setHasORButton

public void setHasORButton(boolean flag)
Specify, if the FindPanel should display the 'OR' button. If true, the FindPanel will display the 'OR>>' button.

Parameters:
flag - to specify if the 'OR>>' button should be displayed

getHasORButton

public boolean getHasORButton()
Determine if the FindPanel has been configured to display the 'OR>>' button

Returns:
true if the 'OR>>'button will be displayed

setHasRemoveButton

public void setHasRemoveButton(boolean flag)
Specify, if the FindPanel should display the 'Remove' button. If true, the FindPanel will display the 'Remove' button.

Parameters:
flag - to specify if the 'Remove'button should be displayed

getHasRemoveButton

public boolean getHasRemoveButton()
Determine if the FindPanel has been configured to display the 'Remove' button

Returns:
true if the 'Remove' button will be displayed

setHasRemoveAllButton

public void setHasRemoveAllButton(boolean flag)
Specify, if the FindPanel should display the 'RemoveAll' button. If true, the FindPanel will display the 'RemoveAll' button.

Parameters:
flag - to specify if the 'RemoveAll'button should be displayed

getHasRemoveAllButton

public boolean getHasRemoveAllButton()
Determine if the FindPanel has been configured to display the 'RemoveAll'button

Returns:
true if the 'RemoveAll' button will be displayed

setHasFindIcon

public void setHasFindIcon(boolean flag)
Specify, if the FindPanel should display the 'Find' icon. If true, the FindPanel will display the Find icon.

Parameters:
flag - to specify if the Find icon should be displayed
See Also:
setFindIcon

getHasFindIcon

public boolean getHasFindIcon()
Determine if the FindPanel has been configured to display the 'Find' icon

Returns:
true if the Find icon will be displayed

setHasStatusBar

public void setHasStatusBar(boolean flag)
Specify, if the FindPanel should display the 'Status bar'. If true, the FindPanel will display the status bar.

Parameters:
flag - to specify if the status bar should be displayed

getHasStatusBar

public boolean getHasStatusBar()
Determine if the FindPanel has been configured to display the status bar

Returns:
true if the Find icon will be displayed

setIcon

public void setIcon(javax.swing.Icon icon)
Specify the Find icon to be used. The Find panel will use a default icon if one is not specified.

Parameters:
icon - FindIcon
See Also:
setHasFindIcon

getIcon

public javax.swing.Icon getIcon()
Get the current 'Find' icon displayed by the FindPanel


setLabelFont

public void setLabelFont(java.awt.Font f)
Specify the font to be used for the label. The Label displays the column name.


getLabelFont

public java.awt.Font getLabelFont()
Get the font currently used for the label.

Returns:
font used for the label

setTextFieldFont

public void setTextFieldFont(java.awt.Font f)
Specify the font to be used for the text field. The text field displays the column value.


getTextFieldFont

public java.awt.Font getTextFieldFont()
Get the font currently used for the text field.

Returns:
font used for the text field

setLabelForegroundColor

public void setLabelForegroundColor(java.awt.Color c)
Specify the foreground color for the label

Parameters:
c - label color

getLabelForegroundColor

public java.awt.Color getLabelForegroundColor()
get the current label color


setLabelBackgroundColor

public void setLabelBackgroundColor(java.awt.Color c)
Specify the label background color


getLabelBackgroundColor

public java.awt.Color getLabelBackgroundColor()
get the current label background color

Returns:
label background color

setTextFieldForegroundColor

public void setTextFieldForegroundColor(java.awt.Color c)
specify the textfield foreground color

Parameters:
c - textfield foreground color

getTextFieldForegroundColor

public java.awt.Color getTextFieldForegroundColor()
get the current textfield foreground color

Returns:
textfield foreground color

setTextFieldBackgroundColor

public void setTextFieldBackgroundColor(java.awt.Color c)
specify the textfield background color

Parameters:
c - textfield background color

getTextFieldBackgroundColor

public java.awt.Color getTextFieldBackgroundColor()
get the textfield background color

Returns:
textfield background color

setTextFieldColumnWidth

public void setTextFieldColumnWidth(int w)
Specify column width for the text field

Parameters:
w - text field column width

getTextFieldColumnWidth

public int getTextFieldColumnWidth()
get the text field column width


setEnabled

public void setEnabled(boolean enabled)
Enable/Disable Find Panel controls.

Specified by:
setEnabled in interface Control
Parameters:
enabled - flag indicating if the controls should be enabled/disabled

isEnabled

public boolean isEnabled()
get the text field column width


setCaseSensitiveSearch

public void setCaseSensitiveSearch(boolean flag)
Specify if case sensitive search is to performed for Character data types. By default this property is true.

Parameters:
flag - true if the search should be case sensitive

isCaseSensitiveSearch

public boolean isCaseSensitiveSearch()
Return true, if the FindPanel does a case sensitive search for character data types.

Returns:
true if the search is case sensitive for Character data types.

setDisableAutomaticWildCardInSearch

public void setDisableAutomaticWildCardInSearch(boolean b)
By default, for character datatypes, wildcard character (%) is added to the search value (ex., 'Miller' is modified to LIKE 'Miller%'. If you wish to override this behaviour set this flag to true. The default value for this flag is false.


isDisableAutomaticWildCardInSearch

public boolean isDisableAutomaticWildCardInSearch()

setBusyCursor

public void setBusyCursor(java.awt.Cursor busyCursor)
Change the cursor used to indicate busy status

Parameters:
busyCursor - cursor to indicated busy status

getBusyCursor

public java.awt.Cursor getBusyCursor()
get the cursor currently used to indicated busy status

Returns:
get the busy cursor

setPostAlways

public void setPostAlways(boolean bflag)
If this flag is true, the transaction changes are posted and the query re-executed. If this flag is false and transaction is dirty, user is prompted to commit the transaction. The default value is true


isPostAlways

public boolean isPostAlways()
indicates if the transaction changes are posted before re-executing the query.


getInnerPanel

public javax.swing.JPanel getInnerPanel()
get the inner panel

Returns:
inner panel

resetFields

public void resetFields()
Clear all the text fields for the current view criteria row


setFindPanelUI

public void setFindPanelUI(FindPanelUI findPanelUI)
customize the UI used to display the Find Panel

Parameters:
findPanelUI -

getFindPanelUI

public FindPanelUI getFindPanelUI()
return the FindPanelUI currently in use

Returns:
FindPanelUI

setCurrentViewCriteriaRow

public void setCurrentViewCriteriaRow(int row)
sets the current view criteria row


getCurrentViewCriteriaRow

public int getCurrentViewCriteriaRow()

getColumnCount

public int getColumnCount()
number of columns used to parameterize the query

Returns:
the number of columns

getColumnDisplayLabel

public java.lang.String getColumnDisplayLabel(int colIndex)
return the column display name for a particular column

Parameters:
colIndex - column index whose display name we are interested in., zero based index used
Returns:
column display name

getColumnValue

public java.lang.Object getColumnValue(int colIndex)
return the column value for a particular column

Parameters:
colIndex - column index whose column value we are interested in., zero based index used
Returns:
column value

setColumnValue

public void setColumnValue(int colIndex,
                           java.lang.Object value)
specify the column value for a particular column

Parameters:
colIndex - column index whose value has to be set zero based index used

getViewCriteriaRowCount

public int getViewCriteriaRowCount()
get the number of rows in the ViewCriteria. This method is useful in implementing the FindPanel UI

Returns:
number of row in the ViewCriteria
See Also:
ViewCriteriaFindPanelUI

newViewCriteriaRow

public void newViewCriteriaRow()
create a new view criteria row. This method is useful in implementing the FindPanel UI

See Also:
ViewCriteriaFindPanelUI

deleteViewCriteriaRow

public void deleteViewCriteriaRow()
delete the current view criteria row. This method is useful in implementing the FindPanel UI

See Also:
ViewCriteriaFindPanelUI

deleteAllViewCriteriaRow

public void deleteAllViewCriteriaRow()
delete all view criteria rows.


runQuery

public void runQuery()
run the query


getViewCriteriaFindAction

public ViewCriteriaFindAction getViewCriteriaFindAction()
obtain the ViewCriteria Find action used by the FindPanel.


setViewCriteriaFindAction

public void setViewCriteriaFindAction(ViewCriteriaFindAction vc)
Specify the ViewCriteriaFind action to be used by the FindPanel.

Parameters:
vc - ViewCriteriaFindAction object

getFindItemModel

public FindItemModel getFindItemModel(int column)
get the item model for the specified column

Parameters:
column - whose model we need

getViewCriteriaModel

public ConstrainedViewCriteriaModel getViewCriteriaModel()
get the ViewCriteriaModel


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)

isFocusValidated

public final boolean isFocusValidated()
Determines whether focus into this control causes validation to occur.

Specified by:
isFocusValidated in interface Control
Returns:
Always false
See Also:
Control.isFocusValidated()

setFocusValidated

public final void setFocusValidated(boolean focusValidated)
This method is a no-op that is it has no effect

Specified by:
setFocusValidated in interface Control
Parameters:
focusValidated - If true, focus into this control will cause validation to occur.
See Also:
ControlSupport.setFocusValidated(boolean)

getComponent

public 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.

addNavigatedListener

public final void addNavigatedListener(NavigatedListener listener)
This method is a no-op

Specified by:
addNavigatedListener in interface Control
Parameters:
listener - The listener to add.
See Also:
ControlSupport.addNavigatedListener(oracle.dacf.control.NavigatedListener)

removeNavigatedListener

public final void removeNavigatedListener(NavigatedListener listener)
This method is a no-op that is it has no effect

Specified by:
removeNavigatedListener in interface Control
Parameters:
listener - The listener to remove.
See Also:
ControlSupport.removeNavigatedListener(oracle.dacf.control.NavigatedListener)

processNavigatedEvent

public final void processNavigatedEvent(NavigatedEvent event)
This method is a no-op

Specified by:
processNavigatedEvent in interface Control
Parameters:
event - The navigated event.
See Also:
ControlSupport.processNavigatedEvent(oracle.dacf.control.NavigatedEvent)

addNavigatingListener

public final void addNavigatingListener(NavigatingListener listener)
This method is a no-op

Specified by:
addNavigatingListener in interface Control
Parameters:
listener - The listener to add.
See Also:
ControlSupport.addNavigatedListener(oracle.dacf.control.NavigatedListener)

removeNavigatingListener

public final void removeNavigatingListener(NavigatingListener listener)
This method is a no-op

Specified by:
removeNavigatingListener in interface Control
Parameters:
listener - The listener to remove.
See Also:
ControlSupport.removeNavigatedListener(oracle.dacf.control.NavigatedListener)

processNavigatingEvent

public final void processNavigatingEvent(NavigatingEvent event)
                                  throws NavigatingException
This method is a no-op in that it has no effect

Specified by:
processNavigatingEvent in interface Control
Parameters:
event - The navigating event.
Throws:
NavigatingException - Indicates navigation rejected.
See Also:
ControlSupport.processNavigatedEvent(oracle.dacf.control.NavigatedEvent)

dataItemValueChanged

public final void dataItemValueChanged(javax.infobus.DataItemValueChangedEvent event)
Indicates a changed value in the bound data item.

A reference to the data item that changed can be obtained from the event.

Specified by:
dataItemValueChanged in interface javax.infobus.DataItemChangeListener
Parameters:
event - Contains change information.
See Also:
DataItemChangeListener.dataItemValueChanged(javax.infobus.DataItemValueChangedEvent)

dataItemAdded

public final void dataItemAdded(javax.infobus.DataItemAddedEvent event)
Indicates that a new item was added to the bound aggregate data item (e.g. ArrayAccess, a JDK Collection, etc).

A reference to the data item that was added, and a reference to the one that gained it, can be obtained from the event.

Specified by:
dataItemAdded in interface javax.infobus.DataItemChangeListener
Parameters:
event - Contains details of the addition.
See Also:
DataItemChangeListener.dataItemAdded(javax.infobus.DataItemAddedEvent)

dataItemDeleted

public final void dataItemDeleted(javax.infobus.DataItemDeletedEvent event)
Indicates that an item was deleted from the bound aggregate data item (e. g. ArrayAccess, a JDK Collection, etc).

A reference to the data item that was deleted, and a reference to the one that lost it, can be obtained from the event.

Specified by:
dataItemDeleted in interface javax.infobus.DataItemChangeListener
Parameters:
event - Contains details of the deletion.
See Also:
DataItemChangeListener.dataItemDeleted(javax.infobus.DataItemDeletedEvent)

dataItemRevoked

public final 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.

A reference to the data item that was revoked can be obtained from the event.

Specified by:
dataItemRevoked in interface javax.infobus.DataItemChangeListener
Parameters:
event - Contains details of the revoked data.
See Also:
DataItemChangeListener.dataItemRevoked(javax.infobus.DataItemRevokedEvent)

rowsetCursorMoved

public final void rowsetCursorMoved(javax.infobus.RowsetCursorMovedEvent event)
Indicates that the cursor for the bound RowsetAccess data item has changed rows.

A reference to the rowset data item can be obtained from the event.

Specified by:
rowsetCursorMoved in interface javax.infobus.DataItemChangeListener
Parameters:
event - Contains details of the cursor move.
See Also:
DataItemChangeListener.rowsetCursorMoved(javax.infobus.RowsetCursorMovedEvent)

setColumnDataItemNameInternal

protected void setColumnDataItemNameInternal(java.lang.String[] dataItemName)

_showBusyCursor

protected void _showBusyCursor()
displays a busy cursor


_restoreDefaultCursor

protected void _restoreDefaultCursor()
show default cursor


_getQueryCriteriaRowset

protected javax.infobus.ScrollableRowsetAccess _getQueryCriteriaRowset()
get query criteria rowset


_applyQueryCriteriaProps

protected void _applyQueryCriteriaProps(javax.infobus.ScrollableRowsetAccess rsAccess,
                                        boolean isCaseSensitive)

_isDataItemNameChanged

protected boolean _isDataItemNameChanged(javax.infobus.DataItem oldDataItem,
                                         javax.infobus.DataItem newDataItem)

Oracle Data-aware Controls Reference

 

Copyright © 1997, 2003, Oracle. All rights reserved.