IlvJTree (Perforce JViews 10.0 API)

java.lang.Object
- java.awt.Component
- - java.awt.Container
  - - javax.swing.JComponent
    - - javax.swing.JTree
      - ilog.views.gantt.swing.IlvJTree

All Implemented Interfaces:

VerticalExpansionListener, VerticalExpansionListener2, IlvVerticalExpandable, ImageObserver, MenuContainer, Serializable, EventListener, Accessible, Scrollable
```
public class IlvJTree
extends JTree
implements IlvVerticalExpandable
```
IlvJTree is a Swing JTree subclass that is designed specifically to integrate easily with the Gantt framework. It will behave as an expandable component when it is added to the Gantt configuration like this: anIlvGanttConfiguration.addVerticalExpandable(anIlvJTree).
IlvJTree uses a client property to determine whether to draw separator lines between each row. This is enabled by default and can be explicitly set by:
```
 anIlvJTree.putClientProperty("IlvJTree.rowSeparators", Boolean.TRUE);
 
```
This can be disabled by:
```
 anIlvJTree.putClientProperty("IlvJTree.rowSeparators", Boolean.FALSE);
 
```
IlvJTree also supports the standard JTree.lineStyle client property that is used by the Metal look and feel to configure how connecting lines are drawn between nodes. The supported values are:
- Angled: A line is drawn connecting child nodes to their parent.
- Horizontal: A horizontal line is drawn dividing the children of the root node.
- None: No lines are drawn between nodes.
The default value is Angled. For example, to switch to Horizontal style you would do:
```
 anIlvJTree.putClientProperty("JTree.lineStyle", "Horizontal");
 
```
For more details on the JTree.lineStyle client property, consult the JDK documentation for the javax.swing.plaf.metal.MetalTreeUI class.
Unlike the standard Swing JTree,IlvJTree does not observe its global isEditable flag to determine whether editing is enabled. Instead, the tree's renderPolicy.isEditable(row) is queried to determine whether editing is enabled on a row by row basis. If the tree does not have a renderPolicy set, editing is disabled for the entire tree.
See Also:

Serialized Form

Nested Class Summary

Nested Classes
Modifier and Type	Class and Description
`static class`	`IlvJTree.DefaultEditor` `DefaultEditor` is a `DefaultTreeCellEditor` that properly implements the `IlvWrappedEditor` interface.

Nested classes/interfaces inherited from class javax.swing.JTree
JTree.AccessibleJTree, JTree.DropLocation, JTree.DynamicUtilTreeNode, JTree.EmptySelectionModel, JTree.TreeModelHandler, JTree.TreeSelectionRedirector

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

Nested classes/interfaces inherited from class java.awt.Container
Container.AccessibleAWTContainer

Nested classes/interfaces inherited from class java.awt.Component
Component.AccessibleAWTComponent, Component.BaselineResizeBehavior, Component.BltBufferStrategy, Component.FlipBufferStrategy

Field Summary
- Fields inherited from class javax.swing.JTree
  ANCHOR_SELECTION_PATH_PROPERTY, CELL_EDITOR_PROPERTY, CELL_RENDERER_PROPERTY, cellEditor, cellRenderer, editable, EDITABLE_PROPERTY, EXPANDS_SELECTED_PATHS_PROPERTY, INVOKES_STOP_CELL_EDITING_PROPERTY, invokesStopCellEditing, LARGE_MODEL_PROPERTY, largeModel, LEAD_SELECTION_PATH_PROPERTY, ROOT_VISIBLE_PROPERTY, rootVisible, ROW_HEIGHT_PROPERTY, rowHeight, SCROLLS_ON_EXPAND_PROPERTY, scrollsOnExpand, SELECTION_MODEL_PROPERTY, selectionModel, selectionRedirector, SHOWS_ROOT_HANDLES_PROPERTY, showsRootHandles, TOGGLE_CLICK_COUNT_PROPERTY, toggleClickCount, TREE_MODEL_PROPERTY, treeModelListener, VISIBLE_ROW_COUNT_PROPERTY, visibleRowCount
- Fields inherited from class javax.swing.JComponent
  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
  accessibleContext, 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

Constructors
Constructor and Description
`IlvJTree()` Constructs a new `IlvJTree`.
`IlvJTree(IlvJTreeRenderPolicy renderPolicy)` Constructs a new `IlvJTree` that will use the specified policy for rendering and editing its rows.

Method Summary

All Methods Instance Methods Concrete Methods Deprecated Methods
Modifier and Type	Method and Description
`protected void`	`baseTextDirectionChanged()` This method is invoked when the effective base text direction has changed.
`protected void`	`componentOrientationChanged(ComponentOrientation oldOrientation, ComponentOrientation newOrientation)` This method is invoked when the component orientation of this tree has changed.
`String`	`convertValueToText(Object row, boolean selected, boolean expanded, boolean leaf, int rowIndex, boolean hasFocus)` Returns the text that will be rendered for the specified row.
`void`	`ganttModelChanged(GanttModelChangedEvent event)` Invoked by the `IlvGanttConfiguration` when the data model has been replaced.
`int`	`getBaseTextDirection()` Returns the base text direction for this tree.
`BasicTreeUI`	`getBasicUI()` Returns the basic L&F object that renders this tree.
`IlvHierarchyNode`	`getFirstVisibleRow()` Returns the first visible row in the tree or `null` if no rows are visible.
`TreePath`	`getPathForRow(IlvHierarchyNode row)` Returns the path for the specified row.
`IlvJTreeRenderPolicy`	`getRenderPolicy()` Returns the policy for rendering and editing rows displayed in this tree.
`int`	`getResolvedBaseTextDirection()` Returns the resolved base text direction.
`IlvHierarchyNode`	`getRootVisibleRow()` Deprecated. Beginning with Perforce JViews 8.5, use `getFirstVisibleRow()` instead.
`IlvHierarchyNode`	`getRow(int rowIndex)` Returns the row that is visible on the specified row index.
`int`	`getRowHeight(IlvHierarchyNode row)` Returns the height of the specified row in the tree.
`int`	`getRowIndex(IlvHierarchyNode row)` Returns the row index that the specified row is displayed on.
`com.ibm.icu.util.ULocale`	`getULocale()` Returns the locale of this tree.
`boolean`	`isExpanded(IlvHierarchyNode row)` Returns whether the specified row is currently expanded.
`protected boolean`	`isLocationInExpandControl(TreePath path, int x, int y)` Returns whether the specified `x`,`y` location is within the area that is used to expand/collapse the row that `path` is displayed on.
`boolean`	`isPathEditable(TreePath path)` Returns whether the specified `path` is editable.
`boolean`	`isVisible(IlvHierarchyNode row)` Returns whether the specified row is visible.
`protected void`	`paintComponent(Graphics g)` Paints the tree.
`protected void`	`paintHorizontalRowSeparators(Graphics g)` Paints the horizontal lines between each row.
`void`	`rootRowVisibilityChanged(RootRowVisibilityChangedEvent event)` This method is invoked by the `Gantt configuration` when the visibility of the root row has been changed.
`void`	`rowCollapsed(IlvHierarchyNode row)` Deprecated. Beginning with Perforce JViews 8.5, an `IlvJTree` can no longer be used in the role of an `IlvVerticalExpansionMaster`. Use an `IlvRowExpansionMaster` instead.
`void`	`rowCollapsed(RowCollapsedEvent event)` Invoked by the `IlvGanttConfiguration` when this tree is configured as an `IlvVerticalExpandable` slave component and a row has been collapsed in the data tree.
`void`	`rowExpanded(IlvHierarchyNode row)` Deprecated. Beginning with Perforce JViews 8.5, an `IlvJTree` can no longer be used in the role of an `IlvVerticalExpansionMaster`. Use an `IlvRowExpansionMaster` instead.
`void`	`rowExpanded(RowExpandedEvent event)` Invoked by the `IlvGanttConfiguration` when this tree is configured as an `IlvVerticalExpandable` slave component and a row has been expanded in the data tree.
`void`	`rowHeightChanged(RowHeightChangedEvent event)` Invoked by the `Gantt configuration` when the row height has been changed.
`void`	`rowMoved(IlvHierarchyNode row, IlvHierarchyNode oldParent, int oldIndex, IlvHierarchyNode newParent, int newIndex)` Deprecated. Beginning with Perforce JViews 8.5, an `IlvJTree` can no longer be used in the role of an `IlvVerticalExpansionMaster`. Use an `IlvRowExpansionMaster` instead.
`void`	`rowMoved(RowMovedEvent event)` Invoked by the `IlvGanttConfiguration` when this tree is configured as an `IlvVerticalExpandable` slave component and a row has been moved within the data tree.
`void`	`rowsInserted(IlvHierarchyNode parent, IlvHierarchyNode[] children, int[] childIndices)` Deprecated. Beginning with Perforce JViews 8.5, an `IlvJTree` can no longer be used in the role of an `IlvVerticalExpansionMaster`. Use an `IlvRowExpansionMaster` instead.
`void`	`rowsInserted(RowsInsertedEvent event)` Invoked by the `IlvGanttConfiguration` when this tree is configured as an `IlvVerticalExpandable` slave component and children have been inserted into a common parent row in the data tree.
`void`	`rowsRemoved(IlvHierarchyNode parent, IlvHierarchyNode[] children, int[] childIndices)` Deprecated. Beginning with Perforce JViews 8.5, an `IlvJTree` can no longer be used in the role of an `IlvVerticalExpansionMaster`. Use an `IlvRowExpansionMaster` instead.
`void`	`rowsRemoved(RowsRemovedEvent event)` Invoked by the `IlvGanttConfiguration` when this tree is configured as an `IlvVerticalExpandable` slave component and children have been removed from a common parent row in the data tree.
`void`	`rowUpdated(IlvHierarchyNode row)` Invoke this method to notify the tree that the representation of the specified `row` has changed.
`void`	`setBaseTextDirection(int btd)` Sets the base text direction for this tree.
`void`	`setComponentOrientation(ComponentOrientation o)` Sets the component orientation of this tree.
`void`	`setExpandableGanttConfigurationImpl(IlvGanttConfiguration ganttConfig)` Sets the Gantt configuration that this UI component is coordinating with.
`protected void`	`setExpandedState(TreePath path, boolean state)` Sets the expanded state of the specified `path`.
`void`	`setExpansionMasterGanttConfigurationImpl(IlvGanttConfiguration ganttConfig)` Deprecated. Beginning with Perforce JViews 8.5, an `IlvJTree` can no longer be used in the role of an `IlvVerticalExpansionMaster`. Use an `IlvRowExpansionMaster` instead.
`void`	`setLocale(Locale locale)` Sets the locale of this component.
`void`	`setRenderPolicy(IlvJTreeRenderPolicy policy)` Sets the rendering and editing policy for rows displayed in this tree.
`void`	`setULocale(com.ibm.icu.util.ULocale locale)` Sets the locale of this component.
`void`	`toggleExpandState(int row)` Expands the specified `row` if it is collapsed, or collapses it if it is currently expanded.
`void`	`toggleExpandState(TreePath path)` Expands `path` if it is collapsed, or collapses it if it is currently expanded.
`void`	`updateUI()` This method is a notification that the L&F has changed.
`void`	`validateRowHeights()` Ensures that the heights of all rows are up-to-date.

Methods inherited from class javax.swing.JTree
addSelectionInterval, addSelectionPath, addSelectionPaths, addSelectionRow, addSelectionRows, addTreeExpansionListener, addTreeSelectionListener, addTreeWillExpandListener, cancelEditing, clearSelection, clearToggledPaths, collapsePath, collapseRow, createTreeModel, createTreeModelListener, expandPath, expandRow, fireTreeCollapsed, fireTreeExpanded, fireTreeWillCollapse, fireTreeWillExpand, fireValueChanged, getAccessibleContext, getAnchorSelectionPath, getCellEditor, getCellRenderer, getClosestPathForLocation, getClosestRowForLocation, getDefaultTreeModel, getDescendantToggledPaths, getDragEnabled, getDropLocation, getDropMode, getEditingPath, getExpandedDescendants, getExpandsSelectedPaths, getInvokesStopCellEditing, getLastSelectedPathComponent, getLeadSelectionPath, getLeadSelectionRow, getMaxSelectionRow, getMinSelectionRow, getModel, getNextMatch, getPathBetweenRows, getPathBounds, getPathForLocation, getPathForRow, getPreferredScrollableViewportSize, getRowBounds, getRowCount, getRowForLocation, getRowForPath, getRowHeight, getScrollableBlockIncrement, getScrollableTracksViewportHeight, getScrollableTracksViewportWidth, getScrollableUnitIncrement, getScrollsOnExpand, getSelectionCount, getSelectionModel, getSelectionPath, getSelectionPaths, getSelectionRows, getShowsRootHandles, getToggleClickCount, getToolTipText, getTreeExpansionListeners, getTreeSelectionListeners, getTreeWillExpandListeners, getUI, getUIClassID, getVisibleRowCount, hasBeenExpanded, isCollapsed, isCollapsed, isEditable, isEditing, isExpanded, isExpanded, isFixedRowHeight, isLargeModel, isPathSelected, isRootVisible, isRowSelected, isSelectionEmpty, isVisible, makeVisible, paramString, removeDescendantSelectedPaths, removeDescendantToggledPaths, removeSelectionInterval, removeSelectionPath, removeSelectionPaths, removeSelectionRow, removeSelectionRows, removeTreeExpansionListener, removeTreeSelectionListener, removeTreeWillExpandListener, scrollPathToVisible, scrollRowToVisible, setAnchorSelectionPath, setCellEditor, setCellRenderer, setDragEnabled, setDropMode, setEditable, setExpandsSelectedPaths, setInvokesStopCellEditing, setLargeModel, setLeadSelectionPath, setModel, setRootVisible, setRowHeight, setScrollsOnExpand, setSelectionInterval, setSelectionModel, setSelectionPath, setSelectionPaths, setSelectionRow, setSelectionRows, setShowsRootHandles, setToggleClickCount, setUI, setVisibleRowCount, startEditingAtPath, stopEditing, treeDidChange

Methods inherited from class javax.swing.JComponent
addAncestorListener, addNotify, addVetoableChangeListener, computeVisibleRect, contains, createToolTip, disable, enable, firePropertyChange, firePropertyChange, firePropertyChange, fireVetoableChange, getActionForKeyStroke, getActionMap, getAlignmentX, getAlignmentY, getAncestorListeners, getAutoscrolls, getBaseline, getBaselineResizeBehavior, getBorder, getBounds, getClientProperty, getComponentGraphics, 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, hide, isDoubleBuffered, isLightweightComponent, isManagingFocus, isOpaque, isOptimizedDrawingEnabled, isPaintingForPrint, isPaintingOrigin, isPaintingTile, isRequestFocusEnabled, isValidateRoot, paint, paintBorder, paintChildren, paintImmediately, paintImmediately, print, printAll, printBorder, printChildren, printComponent, processComponentKeyEvent, processKeyBinding, processKeyEvent, processMouseEvent, processMouseMotionEvent, putClientProperty, registerKeyboardAction, registerKeyboardAction, removeAncestorListener, removeNotify, removeVetoableChangeListener, repaint, repaint, requestDefaultFocus, requestFocus, requestFocus, requestFocusInWindow, requestFocusInWindow, resetKeyboardActions, reshape, revalidate, scrollRectToVisible, setActionMap, setAlignmentX, setAlignmentY, setAutoscrolls, setBackground, setBorder, setComponentPopupMenu, setDebugGraphicsOptions, setDefaultLocale, setDoubleBuffered, setEnabled, setFocusTraversalKeys, setFont, setForeground, setInheritsPopupMenu, 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, 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, processContainerEvent, processEvent, remove, remove, removeAll, removeContainerListener, setComponentZOrder, setFocusCycleRoot, setFocusTraversalPolicy, setFocusTraversalPolicyProvider, setLayout, 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, firePropertyChange, 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, imageUpdate, 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, processComponentEvent, processFocusEvent, processHierarchyBoundsEvent, processHierarchyEvent, processInputMethodEvent, processMouseWheelEvent, remove, removeComponentListener, removeFocusListener, removeHierarchyBoundsListener, removeHierarchyListener, removeInputMethodListener, removeKeyListener, removeMouseListener, removeMouseMotionListener, removeMouseWheelListener, removePropertyChangeListener, removePropertyChangeListener, repaint, repaint, repaint, resize, resize, setBounds, setBounds, setCursor, setDropTarget, setFocusable, setFocusTraversalKeysEnabled, setIgnoreRepaint, setLocation, setLocation, setName, setSize, setSize, show, show, size, toString, transferFocus, transferFocusBackward, transferFocusUpCycle

Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait

- Constructor Detail
  - IlvJTree
```
public IlvJTree()
```
    Constructs a new IlvJTree. The tree rows will be rendered and edited using a default rendering policy.
  - IlvJTree
```
public IlvJTree(IlvJTreeRenderPolicy renderPolicy)
```
    Constructs a new IlvJTree that will use the specified policy for rendering and editing its rows.
    
    Parameters:
    
    renderPolicy - The rendering policy.
- Method Detail
  - getRootVisibleRow
```
@Deprecated
public IlvHierarchyNode getRootVisibleRow()
```
    Deprecated. Beginning with Perforce JViews 8.5, use getFirstVisibleRow() instead.
    
    Returns the first visible row of the tree or null if no rows are rows are visible.
    
    Returns:
    
    The first visible row.
  - getFirstVisibleRow
```
public IlvHierarchyNode getFirstVisibleRow()
```
    Returns the first visible row in the tree or null if no rows are visible. If the data model contains at least a root row and the root row is set visible, then this method will return the root row. If the root row is set not visible, then this method will return the first child of the root row, if it exists in the data model. This method is equivalent to calling getRow(0).
    
    Returns:
    
    The first visible row.
    
    Since:
    
    JViews 8.5
    
    See Also:
    
    JTree.isRootVisible(), JTree.setRootVisible(boolean)
  - getRow
```
public IlvHierarchyNode getRow(int rowIndex)
```
    Returns the row that is visible on the specified row index. If the row index is not visible, null is returned.
    
    Parameters:
    
    rowIndex - The row index.
    
    Returns:
    
    The row on the specified row index or null if rowIndex < 0 or rowIndex >= getRowCount().
  - getRowIndex
```
public int getRowIndex(IlvHierarchyNode row)
```
    Returns the row index that the specified row is displayed on. If the row is not visible, then -1 is returned.
    
    Parameters:
    
    row - The row.
    
    Returns:
    
    The row index that row is visible on, where 0 is the first row, or -1 if row is not visible.
  - getRowHeight
```
public int getRowHeight(IlvHierarchyNode row)
```
    Returns the height of the specified row in the tree.
    
    Parameters:
    
    row - The row. The type of the specified row must match the row organization of the Gantt configuration that the tree is associated with. In other words, if getRowType is IlvGanttConfiguration.ACTIVITY_ROWS, then row must be an IlvActivity. If getRowType is IlvGanttConfiguration.RESOURCE_ROWS, then row must be an IlvResource.
    
    Returns:
    
    The row height.
    
    Since:
    
    JViews 6.0
  - setExpandedState
```
protected void setExpandedState(TreePath path,
                                boolean state)
```
    Sets the expanded state of the specified path. This method is overridden to forward preSetExpandedState and postSetExpandedState methods in the tree's vertical adapter before and after the path is actually expanded.
    
    Overrides:
    
    setExpandedState in class JTree
  - toggleExpandState
```
public void toggleExpandState(TreePath path)
```
    Expands path if it is collapsed, or collapses it if it is currently expanded.
  - toggleExpandState
```
public void toggleExpandState(int row)
```
    Expands the specified row if it is collapsed, or collapses it if it is currently expanded.
    
    Parameters:
    
    row - The display row, where 0 is the first row in the display.
  - isExpanded
```
public boolean isExpanded(IlvHierarchyNode row)
```
    Returns whether the specified row is currently expanded. If the row has no children, false is returned.
    
    Parameters:
    
    row - The row.
    
    Returns:
    
    false if the row has no children, is collapsed, or any of its ancestors are collapsed. Returns true if the row and all of its ancestors are expanded.
  - isVisible
```
public boolean isVisible(IlvHierarchyNode row)
```
    Returns whether the specified row is visible. This means that all of the row ancestors are expanded.
    
    Parameters:
    
    row - The row.
    
    Returns:
    
    true if the row is visible, and false otherwise.
  - getPathForRow
```
public TreePath getPathForRow(IlvHierarchyNode row)
```
    Returns the path for the specified row. This is done by building the parents of row up to and including the root row, where the specified row is the last component in the returned TreePath.
    
    Parameters:
    
    row - The row to get the tree path for.
    
    Returns:
    
    The TreePath from the root to the specified row.
  - isLocationInExpandControl
```
protected boolean isLocationInExpandControl(TreePath path,
                                            int x,
                                            int y)
```
    Returns whether the specified x,y location is within the area that is used to expand/collapse the row that path is displayed on.
    
    Returns:
    
    true if path is not a leaf node and x,y is within its expand/collapse icon area.
  - isPathEditable
```
public boolean isPathEditable(TreePath path)
```
    Returns whether the specified path is editable. This is invoked from the UI before editing begins to insure that the given path can be edited. This method is overridden here to ignore JTree'sisEditable() flag. Instead the tree's renderPolicy is queried for whether the specific row is editable. If the tree does not have a renderPolicy, then false is returned.
    
    Overrides:
    
    isPathEditable in class JTree
    
    See Also:
    
    IlvJTreeRenderPolicy.isEditable(ilog.views.gantt.IlvHierarchyNode)
  - getULocale
```
public com.ibm.icu.util.ULocale getULocale()
```
    Returns the locale of this tree.
    
    Returns:
    
    An ICU ULocale.
    
    Since:
    
    JViews 8.8
    
    See Also:
    
    setULocale(ULocale)
  - setULocale
```
public void setULocale(com.ibm.icu.util.ULocale locale)
```
    Sets the locale of this component.
    
    Parameters:
    
    locale - An ICU ULocale, or null if this component shall inherit its locale from the parent component.
    
    Since:
    
    JViews 8.8
    
    See Also:
    
    getULocale(), setLocale(Locale)
  - setLocale
```
public void setLocale(Locale locale)
```
    Sets the locale of this component.
    
    Overrides:
    
    setLocale in class Component
    
    Parameters:
    
    locale - An Locale, or null if this component shall inherit its locale from the parent component.
    
    See Also:
    
    setULocale(ULocale)
  - setComponentOrientation
```
public void setComponentOrientation(ComponentOrientation o)
```
    Sets the component orientation of this tree.
    
    Overrides:
    
    setComponentOrientation in class Component
    
    Parameters:
    
    o - The orientation for this tree.
    
    Since:
    
    JViews 8.8
  - componentOrientationChanged
```
protected void componentOrientationChanged(ComponentOrientation oldOrientation,
                                           ComponentOrientation newOrientation)
```
    This method is invoked when the component orientation of this tree has changed.
    
    Parameters:
    
    oldOrientation - The component orientation before the change.
    
    newOrientation - The component orientation after the change.
    
    Since:
    
    JViews 8.8
    
    See Also:
    
    Component.getComponentOrientation(), setComponentOrientation(ComponentOrientation)
  - getBaseTextDirection
```
public final int getBaseTextDirection()
```
    Returns the base text direction for this tree.
    The base text direction influences the display of text strings that are composed of segments that are read from left to right as well as of segments that are read from right to left. It determines the order of these segments.
    
    Returns:
    
    One of IlvBidiUtil.COMPONENT_DIRECTION, IlvBidiUtil.CONTEXTUAL_DIRECTION, IlvBidiUtil.LEFT_TO_RIGHT, IlvBidiUtil.RIGHT_TO_LEFT, IlvBidiUtil.INHERITED_DIRECTION.
    
    Since:
    
    JViews 8.8
    
    See Also:
    
    setBaseTextDirection(int), getResolvedBaseTextDirection()
  - setBaseTextDirection
```
public void setBaseTextDirection(int btd)
```
    Sets the base text direction for this tree.
    The base text direction influences the display of text strings that are composed of segments that are read from left to right as well as of segments that are read from right to left. It determines the order of these segments.
    Possible values are: IlvBidiUtil.COMPONENT_DIRECTION, IlvBidiUtil.CONTEXTUAL_DIRECTION, IlvBidiUtil.LEFT_TO_RIGHT, IlvBidiUtil.RIGHT_TO_LEFT, and IlvBidiUtil.INHERITED_DIRECTION.
    
    Parameters:
    
    btd - The base text direction.
    
    Since:
    
    JViews 8.8
    
    See Also:
    
    getBaseTextDirection()
  - getResolvedBaseTextDirection
```
public int getResolvedBaseTextDirection()
```
    Returns the resolved base text direction.
    The base text direction influences the display of text strings that are composed of segments that are read from left to right as well as of segments that are read from right to left. It determines the order of these segments.
    This method is based on getBaseTextDirection() but determines the value when it is inherited from a parent component (IlvBidiUtil.INHERITED_DIRECTION) or dependent on the component orientation (IlvBidiUtil.COMPONENT_DIRECTION).
    
    Returns:
    
    One of IlvBidiUtil.CONTEXTUAL_DIRECTION, IlvBidiUtil.LEFT_TO_RIGHT, IlvBidiUtil.RIGHT_TO_LEFT.
    
    Since:
    
    JViews 8.8
  - baseTextDirectionChanged
```
protected void baseTextDirectionChanged()
```
    This method is invoked when the effective base text direction has changed. That is, it is invoked
    1. when the value of getResolvedBaseTextDirection() has changed, or
    2. when the value of getComponentOrientation() has changed and the value of getResolvedBaseTextDirection() is IlvBidiUtil.CONTEXTUAL_DIRECTION.
    Since:
    
    JViews 8.8
  - getRenderPolicy
```
public IlvJTreeRenderPolicy getRenderPolicy()
```
    Returns the policy for rendering and editing rows displayed in this tree.
    
    Returns:
    
    The rendering and editing policy.
  - setRenderPolicy
```
public void setRenderPolicy(IlvJTreeRenderPolicy policy)
```
    Sets the rendering and editing policy for rows displayed in this tree. If set to null, the tree's default rendering and editing policy will be used.
    
    Parameters:
    
    policy - The rendering and editing policy.
  - convertValueToText
```
public String convertValueToText(Object row,
                                 boolean selected,
                                 boolean expanded,
                                 boolean leaf,
                                 int rowIndex,
                                 boolean hasFocus)
```
    Returns the text that will be rendered for the specified row. This method is overridden to call IlvJTreeRenderPolicy.getValueAsText(ilog.views.gantt.IlvHierarchyNode).
    
    Overrides:
    
    convertValueToText in class JTree
    
    Parameters:
    
    row - The row to be rendered and converted to text.
    
    selected - Indicates whether the node is selected.
    
    expanded - Indicates whether the node is expanded.
    
    leaf - Indicates if the node is a leaf node.
    
    rowIndex - The row index.
    
    hasFocus - Indicates if the node has the focus.
    
    Returns:
    
    The String representation of the node's value.
    
    Since:
    
    JViews 6.0
  - rowUpdated
```
public void rowUpdated(IlvHierarchyNode row)
```
    Invoke this method to notify the tree that the representation of the specified row has changed. The tree will then repaint the row.
    
    Parameters:
    
    row - The row whose visual representation has changed.
  - getBasicUI
```
public BasicTreeUI getBasicUI()
```
    Returns the basic L&F object that renders this tree. This method returns null if the tree has no L&F installed or the L&F is not a subclass of BasicTreeUI.
    
    Returns:
    
    The BasicTreeUI object that renders this tree.
    
    Since:
    
    JViews 6.0
  - updateUI
```
public void updateUI()
```
    This method is a notification that the L&F has changed.
    
    Overrides:
    
    updateUI in class JTree
  - paintComponent
```
protected void paintComponent(Graphics g)
```
    Paints the tree.
    
    Overrides:
    
    paintComponent in class JComponent
    
    Parameters:
    
    g - the Graphics context in which to paint.
  - paintHorizontalRowSeparators
```
protected void paintHorizontalRowSeparators(Graphics g)
```
    Paints the horizontal lines between each row.
    
    Parameters:
    
    g - the Graphics context in which to paint.
  - ganttModelChanged
```
public void ganttModelChanged(GanttModelChangedEvent event)
```
    Invoked by the IlvGanttConfiguration when the data model has been replaced. Logically, the root row has also changed as a result (unless both the old and new Gantt data models have a null root node). However, separate rowsInserted or rowsRemoved events will not be invoked by the Gantt configuration as a result of the data model change being reported.
    
    Specified by:
    
    ganttModelChanged in interface IlvVerticalExpandable
    
    Parameters:
    
    event - The event.
  - rowHeightChanged
```
public void rowHeightChanged(RowHeightChangedEvent event)
```
    Invoked by the Gantt configuration when the row height has been changed.
    
    Specified by:
    
    rowHeightChanged in interface VerticalExpansionListener
    
    Parameters:
    
    event - The event.
    
    Since:
    
    JViews 3.5
  - rootRowVisibilityChanged
```
public void rootRowVisibilityChanged(RootRowVisibilityChangedEvent event)
```
    This method is invoked by the Gantt configuration when the visibility of the root row has been changed.
    
    Specified by:
    
    rootRowVisibilityChanged in interface VerticalExpansionListener2
    
    Parameters:
    
    event - The event.
    
    Since:
    
    JViews 8.5
  - setExpandableGanttConfigurationImpl
```
public void setExpandableGanttConfigurationImpl(IlvGanttConfiguration ganttConfig)
```
    Sets the Gantt configuration that this UI component is coordinating with. This method is invoked when the component is added to the configuration through its addVerticalExpandable() method. The expandable component should initially synchronize its display with the Gantt configuration at this point. Note, however, that the Gantt configuration may or may not have a valid data model at this time and this must be taken into account. The expandable will be subsequently informed when a data model is set or replaced through the ganttModelChanged event.
    Warning: This method is considered to be part of an IlvVerticalExpandable's internal implementation and is not a public API. Only the Gantt configuration should invoke this method.
    
    Specified by:
    
    setExpandableGanttConfigurationImpl in interface IlvVerticalExpandable
    
    Parameters:
    
    ganttConfig - The Gantt configuration that this component is being added to, or null if this component is being removed from its Gantt configuration.
    
    See Also:
    
    IlvGanttConfiguration.addVerticalExpandable(ilog.views.gantt.IlvVerticalExpandable)
  - validateRowHeights
```
public void validateRowHeights()
```
    Ensures that the heights of all rows are up-to-date.
    
    Specified by:
    
    validateRowHeights in interface IlvVerticalExpandable
    
    Since:
    
    JViews 8.8
  - rowsInserted
```
public void rowsInserted(RowsInsertedEvent event)
```
    Invoked by the IlvGanttConfiguration when this tree is configured as an IlvVerticalExpandable slave component and children have been inserted into a common parent row in the data tree. This is the same as an ActivitiesInsertedEvent or ResourcesInsertedEvent, but with additional visibility information about the inserted rows. If the parent row is visible and expanded, the newly inserted children will also be visible. Otherwise, the new children will not be visible.
    
    Specified by:
    
    rowsInserted in interface VerticalExpansionListener
    
    Parameters:
    
    event - The event.
  - rowsRemoved
```
public void rowsRemoved(RowsRemovedEvent event)
```
    Invoked by the IlvGanttConfiguration when this tree is configured as an IlvVerticalExpandable slave component and children have been removed from a common parent row in the data tree. This is the same as an ActivitiesRemovedEvent or ResourcesRemovedEvent, but with additional visibility information about the deleted rows. All, some, or none of the rows removed from the data model may have been visible.
    
    Specified by:
    
    rowsRemoved in interface VerticalExpansionListener
    
    Parameters:
    
    event - The event.
  - rowMoved
```
public void rowMoved(RowMovedEvent event)
```
    Invoked by the IlvGanttConfiguration when this tree is configured as an IlvVerticalExpandable slave component and a row has been moved within the data tree. This is the same as an ActivityMovedEvent or ResourceMovedEvent, but with additional visibility information about the row that was moved.
    
    Specified by:
    
    rowMoved in interface VerticalExpansionListener
    
    Parameters:
    
    event - The event.
  - rowExpanded
```
public void rowExpanded(RowExpandedEvent event)
```
    Invoked by the IlvGanttConfiguration when this tree is configured as an IlvVerticalExpandable slave component and a row has been expanded in the data tree.
    
    Specified by:
    
    rowExpanded in interface VerticalExpansionListener
    
    Parameters:
    
    event - The event.
  - rowCollapsed
```
public void rowCollapsed(RowCollapsedEvent event)
```
    Invoked by the IlvGanttConfiguration when this tree is configured as an IlvVerticalExpandable slave component and a row has been collapsed in the data tree.
    
    Specified by:
    
    rowCollapsed in interface VerticalExpansionListener
    
    Parameters:
    
    event - The event.
  - setExpansionMasterGanttConfigurationImpl
```
@Deprecated
public void setExpansionMasterGanttConfigurationImpl(IlvGanttConfiguration ganttConfig)
```
    Deprecated. Beginning with Perforce JViews 8.5, an IlvJTree can no longer be used in the role of an IlvVerticalExpansionMaster. Use an IlvRowExpansionMaster instead.
    
    Sets the Gantt configuration that this expansion master is coordinating with. This method is invoked when the expansion master is added to the configuration through its IlvGanttConfiguration.setVerticalExpansionMaster(ilog.views.gantt.IlvVerticalExpansionMaster) method. The expansion master should initially synchronize its state with the Gantt configuration at this point. Note, however, that the Gantt configuration may or may not have a valid data model at this time and this must be taken into account. The expansion master will be subsequently informed when a data model is set or replaced through the ganttModelChanged(ilog.views.gantt.event.GanttModelChangedEvent) event.
    Warning: This method is considered to be part of an IlvVerticalExpansionMaster's internal implementation and is not a public API. Only the Gantt configuration should invoke this method.
    
    Parameters:
    
    ganttConfig - The Gantt configuration that this expansion master is being added to, or null if this expansion master is being removed from its Gantt configuration.
  - rowsInserted
```
@Deprecated
public void rowsInserted(IlvHierarchyNode parent,
                                     IlvHierarchyNode[] children,
                                     int[] childIndices)
```
    Deprecated. Beginning with Perforce JViews 8.5, an IlvJTree can no longer be used in the role of an IlvVerticalExpansionMaster. Use an IlvRowExpansionMaster instead.
    
    Invoked by the IlvGanttConfiguration when this tree is configured as an IlvVerticalExpansionMaster and children have been inserted into a common parent row in the data tree. A RowsInsertedEvent is published to all the IlvVerticalExpandable components registered with the Gantt configuration.
    
    Parameters:
    
    parent - The parent row that has had children inserted. If the insertion being reported is the hierarchy's root row, parent should be null, children should be a single element array containing the root row, and childIndices should be a single element array with childIndices[0]=0.
    
    children - The array of child IlvHierarchyNodes that have been inserted. The rows must be arranged in parallel with childIndices, ordered according to their indices within their common parent row from lowest to highest.
    
    childIndices - An int array of the child indices arranged in parallel with children, ordered from lowest to highest. The indices point to the final locations in the parent row where the children were inserted.
  - rowsRemoved
```
@Deprecated
public void rowsRemoved(IlvHierarchyNode parent,
                                    IlvHierarchyNode[] children,
                                    int[] childIndices)
```
    Deprecated. Beginning with Perforce JViews 8.5, an IlvJTree can no longer be used in the role of an IlvVerticalExpansionMaster. Use an IlvRowExpansionMaster instead.
    
    Invoked by the IlvGanttConfiguration when this tree is configured as an IlvVerticalExpansionMaster and children have been removed from a common parent row in the data tree. A RowsRemovedEvent is published to all of the IlvVerticalExpandable components registered with the Gantt configuration.
    
    Parameters:
    
    parent - The parent row that has had children removed. If the deletion being reported is the hierarchy's root row, parent should be null, children should be a single element array containing the root row, and childIndices should be a single element array with childIndices[0]=0.
    
    children - The array of child IlvHierarchyNodes that have been removed. The rows must be arranged in parallel with childIndices, ordered according to their indices within their common parent row from lowest to highest.
    
    childIndices - An int array of the child row indices arranged in parallel with children, ordered from lowest to highest. The indices point to the original locations in the parent row where the children were removed.
  - rowMoved
```
@Deprecated
public void rowMoved(IlvHierarchyNode row,
                                 IlvHierarchyNode oldParent,
                                 int oldIndex,
                                 IlvHierarchyNode newParent,
                                 int newIndex)
```
    Deprecated. Beginning with Perforce JViews 8.5, an IlvJTree can no longer be used in the role of an IlvVerticalExpansionMaster. Use an IlvRowExpansionMaster instead.
    
    Invoked by the IlvGanttConfiguration when this tree is configured as an IlvVerticalExpansionMaster and a row has been moved within the data tree. A RowMovedEvent is published to all the IlvVerticalExpandable components registered with the Gantt configuration.
    
    Parameters:
    
    row - The row that has been moved.
    
    oldParent - The previous parent of the row.
    
    oldIndex - The index of the row within oldParent before it was moved.
    
    newParent - The new parent of the row.
    
    newIndex - The row index within newParent after it has been moved.
  - rowExpanded
```
@Deprecated
public void rowExpanded(IlvHierarchyNode row)
```
    Deprecated. Beginning with Perforce JViews 8.5, an IlvJTree can no longer be used in the role of an IlvVerticalExpansionMaster. Use an IlvRowExpansionMaster instead.
    
    Invoked by the IlvGanttConfiguration when this tree is configured as an IlvVerticalExpansionMaster and a row has been expanded in the data tree. A RowExpandedEvent is published to all the IlvVerticalExpandable components registered with the Gantt configuration.
    
    Parameters:
    
    row - The expanded row.
  - rowCollapsed
```
@Deprecated
public void rowCollapsed(IlvHierarchyNode row)
```
    Deprecated. Beginning with Perforce JViews 8.5, an IlvJTree can no longer be used in the role of an IlvVerticalExpansionMaster. Use an IlvRowExpansionMaster instead.
    
    Invoked by the IlvGanttConfiguration when this tree is configured as an IlvVerticalExpansionMaster and a row has been collapsed in the data tree. A RowCollapsedEvent is published to all the IlvVerticalExpandable components registered with the Gantt configuration.
    
    Parameters:
    
    row - The collapsed row.

Class IlvJTree

Nested Class Summary

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

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

Nested classes/interfaces inherited from class java.awt.Container

Nested classes/interfaces inherited from class java.awt.Component

Field Summary

Fields inherited from class javax.swing.JTree

Fields inherited from class javax.swing.JComponent

Fields inherited from class java.awt.Component

Fields inherited from interface java.awt.image.ImageObserver

Constructor Summary

Method Summary

Methods inherited from class javax.swing.JTree

Methods inherited from class javax.swing.JComponent

Methods inherited from class java.awt.Container

Methods inherited from class java.awt.Component

Methods inherited from class java.lang.Object

Constructor Detail

IlvJTree

IlvJTree

Method Detail

getRootVisibleRow

getFirstVisibleRow

getRow

getRowIndex

getRowHeight

setExpandedState

toggleExpandState

toggleExpandState

isExpanded

isVisible

getPathForRow

isLocationInExpandControl

isPathEditable

getULocale

setULocale

setLocale

setComponentOrientation

componentOrientationChanged

getBaseTextDirection

setBaseTextDirection

getResolvedBaseTextDirection

baseTextDirectionChanged

getRenderPolicy

setRenderPolicy

convertValueToText

rowUpdated

getBasicUI

updateUI

paintComponent

paintHorizontalRowSeparators

ganttModelChanged

rowHeightChanged

rootRowVisibilityChanged

setExpandableGanttConfigurationImpl

validateRowHeights

rowsInserted

rowsRemoved

rowMoved

rowExpanded

rowCollapsed

setExpansionMasterGanttConfigurationImpl

rowsInserted

rowsRemoved

rowMoved

rowExpanded

rowCollapsed