Package org.eclipse.ui.dialogs
Class ContainerCheckedTreeViewer
- All Implemented Interfaces:
ICheckable,IInputProvider,IInputSelectionProvider,IPostSelectionProvider,ISelectionProvider
CheckboxTreeViewer with special behaviour of the checked / gray state on
container (non-leaf) nodes: The grayed state is used to visualize the checked
state of its children. Containers are checked and non-gray if all contained
leafs are checked. The container is grayed if some but not all leafs are
checked.
- Since:
- 3.1
-
Nested Class Summary
Nested classes/interfaces inherited from class org.eclipse.jface.viewers.StructuredViewer
StructuredViewer.ColorAndFontCollector, StructuredViewer.ColorAndFontCollectorWithProviders -
Field Summary
Fields inherited from class org.eclipse.jface.viewers.AbstractTreeViewer
ALL_LEVELS, NO_EXPANDFields inherited from class org.eclipse.jface.viewers.Viewer
WIDGET_DATA_KEY -
Constructor Summary
ConstructorsConstructorDescriptionContainerCheckedTreeViewer(Composite parent) Constructor for ContainerCheckedTreeViewer.ContainerCheckedTreeViewer(Composite parent, int style) Constructor for ContainerCheckedTreeViewer.Constructor for ContainerCheckedTreeViewer. -
Method Summary
Modifier and TypeMethodDescriptionprotected voiddoCheckStateChanged(Object element) Update element after a checkstate change.Object[]Returns a list of checked elements in this viewer's tree, including currently hidden ones that are marked as checked but are under a collapsed ancestor.booleansetChecked(Object element, boolean state) Sets the checked state for the given element in this viewer.voidsetCheckedElements(Object[] elements) Sets which elements are checked in this viewer's tree.protected voidsetExpanded(Item item, boolean expand) Sets the expand state of the given item.booleansetSubtreeChecked(Object element, boolean state) Sets the checked state for the given element and its visible children in this viewer.Methods inherited from class org.eclipse.jface.viewers.CheckboxTreeViewer
addCheckStateListener, doUpdateItem, fireCheckStateChanged, getChecked, getGrayed, getGrayedElements, handleDoubleSelect, handleSelect, preservingSelection, removeCheckStateListener, setAllChecked, setCheckedChildren, setCheckStateProvider, setGrayChecked, setGrayed, setGrayedElements, setParentsGrayedMethods inherited from class org.eclipse.jface.viewers.TreeViewer
addTreeListener, assertContentProviderType, createViewerEditor, disassociate, doGetColumnCount, editElement, getChild, getChildren, getColumnViewerOwner, getControl, getExpanded, getItemAt, getItemCount, getItemCount, getItems, getLabelProvider, getParentElement, getParentItem, getRawChildren, getSelection, getTree, getViewerRowFromItem, handleTreeCollapse, handleTreeExpand, hookControl, internalAdd, internalInitializeTree, internalRefreshStruct, isExpandable, mapElement, newItem, remove, removeAll, replace, setChildCount, setContentProvider, setHasChildren, setSelection, setSelection, showItem, updatePlusMethods inherited from class org.eclipse.jface.viewers.AbstractTreeViewer
add, add, addSelectionListener, addTreeListener, associate, buildLabel, collapseAll, collapseToLevel, contains, createChildren, createTreeItem, doFindInputItem, doFindItem, doUpdateItem, expandAll, expandAll, expandToLevel, expandToLevel, expandToLevel, expandToLevel, fireTreeCollapsed, fireTreeExpanded, getAutoExpandLevel, getAutoExpandOnSingleChildLevels, getChildren, getExpandedElements, getExpandedState, getExpandedTreePaths, getNextItem, getPreviousItem, getSelection, getSelectionFromWidget, getSortedChildren, getStructuredSelection, getTreePathFromItem, getVisibleExpandedElements, indexForElement, inputChanged, insert, internalCollapseToLevel, internalExpand, internalExpandToLevel, internalFindItems, internalGetWidgetToSelect, internalIsInputOrEmptyPath, internalRefresh, internalRefresh, internalRefresh, internalRemove, internalRemove, isSameSelection, labelProviderChanged, remove, remove, remove, removeTreeListener, reveal, scrollDown, scrollUp, setAutoExpandLevel, setAutoExpandOnSingleChildLevels, setExpandedElements, setExpandedState, setExpandedStateWithAutoExpandOnSingleChild, setExpandedTreePaths, setExpandPreCheckFilters, setSelectionToWidget, setSelectionToWidget, updateChildrenMethods inherited from class org.eclipse.jface.viewers.ColumnViewer
applyEditorValue, cancelEditing, checkBusy, firePostSelectionChanged, getCell, getCellEditors, getCellModifier, getColumnProperties, getColumnViewerEditor, getItem, getLabelProvider, getViewerRow, handleDispose, hookEditingSupport, isBusy, isCellEditorActive, isExpandableNode, refresh, refresh, setBusy, setCellEditors, setCellModifier, setColumnProperties, setColumnViewerEditor, setDisplayIncrementally, setLabelProvider, triggerEditorActivationEvent, unmapAllElements, update, updateSelectionMethods inherited from class org.eclipse.jface.viewers.StructuredViewer
addDoubleClickListener, addDragSupport, addDropSupport, addFilter, addOpenListener, addPostSelectionChangedListener, assertElementsNotNull, equals, filter, findItem, findItems, fireDoubleClick, fireOpen, getColorAndFontCollector, getComparator, getComparer, getFilteredChildren, getFilters, getRoot, getSorter, handleInvalidSelection, handleLabelProviderChanged, handleOpen, handlePostSelect, hasFilters, internalUpdate, needsRefilter, refresh, refresh, refreshItem, removeDoubleClickListener, removeFilter, removeOpenListener, removePostSelectionChangedListener, resetFilters, setComparator, setComparer, setFilters, setInput, setSorter, setUseHashlookup, testFindItem, testFindItems, unmapElement, unmapElement, update, updateItem, usingElementMapMethods inherited from class org.eclipse.jface.viewers.ContentViewer
getContentProvider, getInputMethods inherited from class org.eclipse.jface.viewers.Viewer
addHelpListener, addSelectionChangedListener, fireHelpRequested, fireSelectionChanged, getData, handleHelpRequest, removeHelpListener, removeSelectionChangedListener, setData, setSelectionMethods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, waitMethods inherited from interface org.eclipse.jface.viewers.ISelectionProvider
addSelectionChangedListener, removeSelectionChangedListener, setSelection
-
Constructor Details
-
ContainerCheckedTreeViewer
Constructor for ContainerCheckedTreeViewer.- See Also:
-
ContainerCheckedTreeViewer
Constructor for ContainerCheckedTreeViewer.- See Also:
-
ContainerCheckedTreeViewer
Constructor for ContainerCheckedTreeViewer.- See Also:
-
-
Method Details
-
doCheckStateChanged
Update element after a checkstate change.- Parameters:
element- the element to update
-
setChecked
Description copied from interface:ICheckableSets the checked state for the given element in this viewer. Does not fire events to check state listeners.- Specified by:
setCheckedin interfaceICheckable- Overrides:
setCheckedin classCheckboxTreeViewer- Parameters:
element- the elementstate-trueif the item should be checked, andfalseif it should be unchecked- Returns:
trueif the checked state could be set, andfalseotherwise
-
setCheckedElements
Description copied from class:CheckboxTreeViewerSets which elements are checked in this viewer's tree. The given list contains the elements that are to be checked; all other elements are to be unchecked. Does not fire events to check state listeners.This method is typically used when restoring the interesting state of a viewer captured by an earlier call to
getCheckedElements.- Overrides:
setCheckedElementsin classCheckboxTreeViewer- Parameters:
elements- the array of checked elements- See Also:
-
setSubtreeChecked
Description copied from class:CheckboxTreeViewerSets the checked state for the given element and its visible children in this viewer. Assumes that the element has been expanded before. To enforce that the item is expanded, callexpandToLevelfor the element. Does not fire events to check state listeners.- Overrides:
setSubtreeCheckedin classCheckboxTreeViewer- Parameters:
element- the elementstate-trueif the item should be checked, andfalseif it should be unchecked- Returns:
trueif the checked state could be set, andfalseotherwise
-
setExpanded
Description copied from class:AbstractTreeViewerSets the expand state of the given item.- Overrides:
setExpandedin classTreeViewer- Parameters:
item- the itemexpand- the expand state of the item
-
getCheckedElements
Description copied from class:CheckboxTreeViewerReturns a list of checked elements in this viewer's tree, including currently hidden ones that are marked as checked but are under a collapsed ancestor.This method is typically used when preserving the interesting state of a viewer;
setCheckedElementsis used during the restore.- Overrides:
getCheckedElementsin classCheckboxTreeViewer- Returns:
- the array of checked elements
- See Also:
-