public interface IlpTreeSelectionModel extends TreeSelectionModel, IlpRepresentationObjectSelectionModel, IlpObjectSelectionModel
IlpTree
.
This model maintains the selection of IlpObject
s as well as
IlpRepresentationObject
s.
In addition to the common TreePath
and Row
interfaces, Object
and RepresentationObject
interfaces are provided, which allows you to manipulate the selection of
IlpObject
s and IlpTreeNode
s directly.
We strongly discourages the use of the Row
interface and the
CONTIGUOUS_TREE_SELECTION
mode with IlpTreeView
. In
particular, you should be aware that the Row
interface ignores
the hidden nodes (descendants of collapsed nodes). So a node that
is selected but hidden will not be returned by
getSelectionRows()
.
In addition, contiguity is based on the expanded nodes, so you may lose
selected hidden nodes when using CONTIGUOUS_TREE_SELECTION
.
CONTIGUOUS_TREE_SELECTION, DISCONTIGUOUS_TREE_SELECTION, SINGLE_TREE_SELECTION
addPropertyChangeListener, addSelectionPath, addSelectionPaths, addTreeSelectionListener, clearSelection, getLeadSelectionPath, getLeadSelectionRow, getMaxSelectionRow, getMinSelectionRow, getRowMapper, getSelectionCount, getSelectionMode, getSelectionPath, getSelectionPaths, getSelectionRows, isPathSelected, isRowSelected, isSelectionEmpty, removePropertyChangeListener, removeSelectionPath, removeSelectionPaths, removeTreeSelectionListener, resetRowSelection, setRowMapper, setSelectionMode, setSelectionPath, setSelectionPaths
addSelectionRepresentationObject, clearSelection, getSelectedRepresentationObject, getSelectedRepresentationObjects, isRepresentationObjectSelected, removeSelectionRepresentationObject, setSelectedRepresentationObjects
addSelectionObject, clearSelection, getSelectedObject, getSelectedObjects, isObjectSelected, removeSelectionObject, setSelectedObject, setSelectedObjects
IlpRepresentationObject getLeadSelectionRepresentationObject()
void addSelectionRepresentationObjects(Collection objects)
objects
to the current selection. If any of the
representation objects in objects
are not currently in the
selection, the TreeSelectionListeners
are notified. This method has no effect if
objects
is null
.
The lead path is set to the last element in objects
.
If the selection mode is CONTIGUOUS_TREE_SELECTION
and adding the new objects makes the selection discontiguous,
one of two situations may occur: if the IlpRepresentationObject
s
in objects
are contiguous, these
IlpRepresentationObject
s will become the selection; if the
IlpRepresentationObject
s are not contiguous,
the first IlpRepresentationObject
in
objects
will become the selection.
objects
- The new objects to be added to the current selection.void removeSelectionRepresentationObjects(Collection objects)
objects
from the selection. If any of the objects in
objects
are part of the selection, the TreeSelectionListeners
are
notified. This method has no effect if objects
is null
.removeSelectionRepresentationObjects
in interface IlpRepresentationObjectSelectionModel
objects
- The objects to be removed from the selection.@Deprecated void setSelectionRepresentationObject(IlpRepresentationObject object)
setSelectedRepresentationObject
instead.object
. If this operation represents a change, then
the TreeSelectionListeners
are notified. If object
is
null
, this method has the same effect as invoking
clearSelection
.object
- The new object to select.@Deprecated void setSelectionRepresentationObjects(Collection objects)
setSelectedRepresentationObjects
instead.object
.
If this represents a change, the TreeSelectionListeners
are notified.
If object
is null
, this method has the same effect as invoking
clearSelection
.
The lead path is set to the last object in objects
.
If the selection mode is CONTIGUOUS_TREE_SELECTION
,
and adding the new objects makes the selection discontiguous,
the selection is reset to the first IlpRepresentationObject
in
object
.
objects
- The new selection.void setSelectedRepresentationObject(IlpRepresentationObject object)
object
. If this operation represents a change, then
the TreeSelectionListeners
are notified. If object
is
null
, this method has the same effect as invoking
clearSelection
.setSelectedRepresentationObject
in interface IlpRepresentationObjectSelectionModel
object
- The new object to select.void setRepresentationObjectMapper(IlpRepresentationObjectMapper representationObjectMapper)
IlpRepresentationObjectMapper
which will
be used to find the IlpRepresentationObject
associated with an IlpObject
.representationObjectMapper
- The representation object mapper to be
used. If this parameter is null
, the IlpObject
selection API
has no effect.IlpRepresentationObjectMapper getRepresentationObjectMapper()
IlpRepresentationObjectMapper
used
to find the IlpRepresentationObject
associated
with an IlpObject
.null
.© Copyright Rogue Wave Software, Inc. 1997, 2018. All Rights Reserved.