Extension SDK 10.1.2

oracle.javatools.editor.insight
Class TooltipInsightView

java.lang.Object
  extended byjava.awt.Component
      extended byjava.awt.Container
          extended byjavax.swing.JComponent
              extended byjavax.swing.JList
                  extended byoracle.javatools.editor.insight.TooltipInsightView
All Implemented Interfaces:
javax.accessibility.Accessible, java.awt.image.ImageObserver, InsightView, java.awt.MenuContainer, javax.swing.Scrollable, java.io.Serializable

public class TooltipInsightView
extends javax.swing.JList
implements InsightView

The TooltipInsightView class is an implementation of the InsightView to support tooltip insight using a list-type data model. The data is displayed inside a JList and rendered with a custom list cell renderer if one is provided.

The default implementation of TooltipDataItemCellRenderer can be used, which will render the list cells with just a plain label.

The TooltipInsightData can be used as an abstract starting point for your own InsightData implementation, but is not required. Your implementation must however implement the ListInsightData interface, since this view is based on a list model. You may wish to make use of the provided TooltipDataItemListModel to take care of ListModel functionality for convenience.

See Also:
InsightView, TooltipInsightData, TooltipDataItem, TooltipDataItemCellRenderer, Serialized Form

Nested Class Summary
 
Nested classes inherited from class javax.swing.JList
javax.swing.JList.AccessibleJList
 
Nested classes inherited from class javax.swing.JComponent
javax.swing.JComponent.AccessibleJComponent
 
Nested classes inherited from class java.awt.Container
java.awt.Container.AccessibleAWTContainer
 
Nested classes inherited from class java.awt.Component
java.awt.Component.AccessibleAWTComponent, java.awt.Component.BltBufferStrategy, java.awt.Component.FlipBufferStrategy
 
Field Summary
 
Fields inherited from class javax.swing.JList
HORIZONTAL_WRAP, VERTICAL, VERTICAL_WRAP
 
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 java.awt.image.ImageObserver
ABORT, ALLBITS, ERROR, FRAMEBITS, HEIGHT, PROPERTIES, SOMEBITS, WIDTH
 
Constructor Summary
TooltipInsightView()
          Constructs a new TooltipInsightView with no custom cell renderer.
TooltipInsightView(javax.swing.ListCellRenderer renderer)
          Constructs a new TooltipInsightView with no data, but with the specified cell renderer.
TooltipInsightView(ListInsightData insightData)
          Constructs a new TooltipInsightView with the given insight data, but no cell renderer.
TooltipInsightView(ListInsightData insightData, javax.swing.ListCellRenderer renderer)
          Constructs a new TooltipInsightView with the given insight data and cell renderer.
 
Method Summary
 boolean begin()
          Command to move the selection of the view to the top of the data set.
 boolean complete(Insight insight)
          Command to accept (complete) the current insight selection into the document.
 boolean down()
          Command to move the selection of the view to the next item (down) in the data set.
 boolean end()
          Command to move the selection of the view to the bottom of the data set.
 javax.swing.JComponent getComponent()
          Fetches the Swing UI component for displaying this view.
 InsightData getData()
          Fetches the InsightData that is the data model associated with this particular view.
 boolean left()
          Command to move the selection of the view to the left item in the data set.
 boolean pageDown()
          Command to move the selection of the view down by one page in the data set.
 boolean pageUp()
          Command to move the selection of the view up by one page in the data set.
 boolean partialComplete()
          Command to request partial completion using the current insight information based on the current document contents.
 boolean right()
          Command to move the selection of the view to the right item in the data set.
 void selectDefault()
          Instructs the InsightView to select the default insight data item, and to make sure that it is visible.
 void setData(InsightData newData)
          Sets the InsightData data model which should be displayed by this view.
 void setPopupWindow(oracle.javatools.editor.popup.PopupWindow popup)
          Sets the PopupWindow so we can set the accessible name of the selected item on the window so it will be read.
 void setUI(javax.swing.plaf.ListUI ui)
          Sets the look and feel (L&F) object that renders this component.
 boolean up()
          Command to move the selection of the view to the previous item (up) in the data set.
 
Methods inherited from class javax.swing.JList
addListSelectionListener, addSelectionInterval, clearSelection, createSelectionModel, ensureIndexIsVisible, fireSelectionValueChanged, getAccessibleContext, getAnchorSelectionIndex, getCellBounds, getCellRenderer, getDragEnabled, getFirstVisibleIndex, getFixedCellHeight, getFixedCellWidth, getLastVisibleIndex, getLayoutOrientation, getLeadSelectionIndex, getListSelectionListeners, getMaxSelectionIndex, getMinSelectionIndex, getModel, getNextMatch, getPreferredScrollableViewportSize, getPrototypeCellValue, getScrollableBlockIncrement, getScrollableTracksViewportHeight, getScrollableTracksViewportWidth, getScrollableUnitIncrement, getSelectedIndex, getSelectedIndices, getSelectedValue, getSelectedValues, getSelectionBackground, getSelectionForeground, getSelectionMode, getSelectionModel, getToolTipText, getUI, getUIClassID, getValueIsAdjusting, getVisibleRowCount, indexToLocation, isSelectedIndex, isSelectionEmpty, locationToIndex, paramString, removeListSelectionListener, removeSelectionInterval, setCellRenderer, setDragEnabled, setFixedCellHeight, setFixedCellWidth, setLayoutOrientation, setListData, setListData, setModel, setPrototypeCellValue, setSelectedIndex, setSelectedIndices, setSelectedValue, setSelectionBackground, setSelectionForeground, setSelectionInterval, setSelectionMode, setSelectionModel, setValueIsAdjusting, setVisibleRowCount, 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, 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, setEnabled, 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, isEnabled, isFocusable, isFocusOwner, isFocusTraversable, isFontSet, isForegroundSet, isLightweight, isShowing, isValid, isVisible, keyDown, keyUp, list, list, list, location, lostFocus, mouseDown, mouseDrag, mouseEnter, mouseExit, mouseMove, mouseUp, move, nextFocus, paintAll, postEvent, prepareImage, prepareImage, processComponentEvent, processFocusEvent, processHierarchyBoundsEvent, processHierarchyEvent, processInputMethodEvent, processMouseEvent, processMouseWheelEvent, remove, removeComponentListener, removeFocusListener, removeHierarchyBoundsListener, removeHierarchyListener, removeInputMethodListener, removeKeyListener, removeMouseListener, removeMouseMotionListener, removeMouseWheelListener, repaint, repaint, repaint, resize, resize, setBounds, setBounds, setComponentOrientation, setCursor, setDropTarget, setFocusable, setFocusTraversalKeysEnabled, setIgnoreRepaint, setLocale, setLocation, setLocation, setName, setSize, setSize, show, show, size, toString, transferFocus, transferFocusUpCycle
 
Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait
 

Constructor Detail

TooltipInsightView

public TooltipInsightView()
Constructs a new TooltipInsightView with no custom cell renderer. This will just construct an empty list with our default TooltipDataItemCellRenderer


TooltipInsightView

public TooltipInsightView(javax.swing.ListCellRenderer renderer)
Constructs a new TooltipInsightView with no data, but with the specified cell renderer. Since the data list is empty, the data to be displayed must be set with a separate call to setData() to display any data.

Parameters:
renderer - the cell renderer to use

TooltipInsightView

public TooltipInsightView(ListInsightData insightData)
Constructs a new TooltipInsightView with the given insight data, but no cell renderer. This will render the list with the Swing default list cell renderer. The cell renderer may be changed later with a call to setCellRenderer() with the appropriate cell renderer to use.

Parameters:
insightData - the insight data to use for the data model

TooltipInsightView

public TooltipInsightView(ListInsightData insightData,
                          javax.swing.ListCellRenderer renderer)
Constructs a new TooltipInsightView with the given insight data and cell renderer.

Parameters:
renderer - the cell renderer to use
insightData - the insight data to use for the data model
Method Detail

setUI

public void setUI(javax.swing.plaf.ListUI ui)
Sets the look and feel (L&F) object that renders this component. Override the default so that we can also set the color look of this component to match a tooltip.

Parameters:
ui - the ListUI L&F object

setPopupWindow

public void setPopupWindow(oracle.javatools.editor.popup.PopupWindow popup)
Sets the PopupWindow so we can set the accessible name of the selected item on the window so it will be read.

Specified by:
setPopupWindow in interface InsightView

setData

public void setData(InsightData newData)
Sets the InsightData data model which should be displayed by this view.

Specified by:
setData in interface InsightView
Parameters:
newData - the data model to use

selectDefault

public void selectDefault()
Instructs the InsightView to select the default insight data item, and to make sure that it is visible. This may be necessary as the InsightData instance may be set into the view using setData() before the actual view is even visible.

Specified by:
selectDefault in interface InsightView

getData

public InsightData getData()
Fetches the InsightData that is the data model associated with this particular view.

Specified by:
getData in interface InsightView
Returns:
the InsightData that is displayed by this view

getComponent

public javax.swing.JComponent getComponent()
Fetches the Swing UI component for displaying this view.

Specified by:
getComponent in interface InsightView
Returns:
the Swing UI component for displaying this view.

up

public boolean up()
Command to move the selection of the view to the previous item (up) in the data set.

Specified by:
up in interface InsightView
Returns:
false, as the tooltip view does not support navigation

down

public boolean down()
Command to move the selection of the view to the next item (down) in the data set.

Specified by:
down in interface InsightView
Returns:
false, as the tooltip view does not support navigation

right

public boolean right()
Command to move the selection of the view to the right item in the data set.

Specified by:
right in interface InsightView
Returns:
false, as the tooltip view does not support navigation

left

public boolean left()
Command to move the selection of the view to the left item in the data set.

Specified by:
left in interface InsightView
Returns:
false, as the tooltip view does not support navigation

pageUp

public boolean pageUp()
Command to move the selection of the view up by one page in the data set.

Specified by:
pageUp in interface InsightView
Returns:
false, as the tooltip view does not support navigation

pageDown

public boolean pageDown()
Command to move the selection of the view down by one page in the data set.

Specified by:
pageDown in interface InsightView
Returns:
false, as the tooltip view does not support navigation

begin

public boolean begin()
Command to move the selection of the view to the top of the data set.

Specified by:
begin in interface InsightView
Returns:
false, as the tooltip view does not support navigation

end

public boolean end()
Command to move the selection of the view to the bottom of the data set.

Specified by:
end in interface InsightView
Returns:
false, as the tooltip view does not support navigation

complete

public boolean complete(Insight insight)
Description copied from interface: InsightView
Command to accept (complete) the current insight selection into the document. This occurs when the user hits the "Enter" key while Insight information is visible. This method is responding for hiding the Insight window and retriggering the Insight auto-popup if necessary.

Specified by:
complete in interface InsightView
Parameters:
insight - the main Insight engine for the purpose of hiding or re-triggering Insight
Returns:
true if this Insight supports completion assistance

partialComplete

public boolean partialComplete()
Command to request partial completion using the current insight information based on the current document contents. This occurs when the user hits the "Tab" key while insight information is available.

Specified by:
partialComplete in interface InsightView
Returns:
false, as the tooltip view does not support completion

Extension SDK

 

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