Follow Techotopia on Twitter

On-line Guides
All Guides
eBook Store
iOS / Android
Linux for Beginners
Office Productivity
Linux Installation
Linux Security
Linux Utilities
Linux Virtualization
Linux Kernel
System/Network Admin
Programming
Scripting Languages
Development Tools
Web Development
GUI Toolkits/Desktop
Databases
Mail Systems
openSolaris
Eclipse Documentation
Techotopia.com
Virtuatopia.com
Answertopia.com

How To Guides
Virtualization
General System Admin
Linux Security
Linux Filesystems
Web Servers
Graphics & Desktop
PC Hardware
Windows
Problem Solutions
Privacy Policy

  




 

 


Eclipse Platform
Release 3.5

org.eclipse.ui.dialogs
Class CheckedTreeSelectionDialog


java.lang.Object
  extended by 

org.eclipse.jface.window.Window
      extended by 

org.eclipse.jface.dialogs.Dialog
          extended by 

org.eclipse.jface.dialogs.TrayDialog
              extended by 

org.eclipse.ui.dialogs.SelectionDialog
                  extended by 

org.eclipse.ui.dialogs.SelectionStatusDialog
                      extended by 
org.eclipse.ui.dialogs.CheckedTreeSelectionDialog
All Implemented Interfaces:
IShellProvider

public class CheckedTreeSelectionDialog
extends SelectionStatusDialog

A class to select elements out of a tree structure.

Since:
2.0

Nested Class Summary
 
Nested classes/interfaces inherited from class org.eclipse.jface.window. Window
Window.IExceptionHandler
 
Field Summary
 
Fields inherited from class org.eclipse.jface.dialogs. Dialog
blockedHandler, buttonBar, DIALOG_DEFAULT_BOUNDS, DIALOG_PERSISTLOCATION, DIALOG_PERSISTSIZE, dialogArea, DLG_IMG_ERROR, DLG_IMG_HELP, DLG_IMG_INFO, DLG_IMG_MESSAGE_ERROR, DLG_IMG_MESSAGE_INFO, DLG_IMG_MESSAGE_WARNING, DLG_IMG_QUESTION, DLG_IMG_WARNING, ELLIPSIS
 
Fields inherited from class org.eclipse.jface.window. Window
CANCEL, OK
 
Constructor Summary
CheckedTreeSelectionDialog ( Shell parent, ILabelProvider labelProvider, ITreeContentProvider contentProvider)
          Constructs an instance of ElementTreeSelectionDialog.
 
Method Summary
 void addFilter ( ViewerFilter filter)
          Adds a filter to the tree viewer.
protected  void cancelPressed ()
          Handles cancel button pressed event.
protected  void computeResult ()
          Compute the result and return it.
 void create ()
          Creates this window's widgetry in a new top-level shell.
protected   Control createDialogArea ( Composite parent)
          Creates and returns the contents of the upper part of this dialog (above the button bar).
protected   Composite createSelectionButtons ( Composite composite)
          Adds the selection and deselection buttons to the dialog.
protected   CheckboxTreeViewer createTreeViewer ( Composite parent)
          Creates the tree viewer.
protected   CheckboxTreeViewer getTreeViewer ()
          Returns the tree viewer.
 int open ()
          Opens this window, creating it first if it has not yet been created.
 void setComparator ( ViewerComparator comparator)
          Sets the comparator used by the tree viewer.
 void setContainerMode (boolean containerMode)
          If set, the checked /gray state of containers (inner nodes) is derived from the checked state of its leaf nodes.
 void setEmptyListMessage ( String message)
          Sets the message to be displayed if the list is empty.
 void setExpandedElements ( Object[] elements)
          Expands elements in the tree.
 void setInitialSelection ( Object selection)
          Sets the initial selection.
 void setInput ( Object input)
          Sets the tree input.
 void setSize (int width, int height)
          Sets the size of the tree in unit of characters.
 void setSorter ( ViewerSorter sorter)
          Deprecated. since 3.3, use setComparator(ViewerComparator) instead
 void setValidator ( ISelectionStatusValidator validator)
          Sets an optional validator to check if the selection is valid.
protected  void updateOKStatus ()
          Validate the receiver and update the status with the result.
 
Methods inherited from class org.eclipse.ui.dialogs. SelectionStatusDialog
configureShell, createButtonBar, getFirstResult, okPressed, setImage, setResult, setStatusLineAboveButtons, updateButtonsEnableState, updateStatus
 
Methods inherited from class org.eclipse.ui.dialogs. SelectionDialog
createButtonsForButtonBar, createMessageArea, getDialogBoundsSettings, getDialogBoundsStrategy, getInitialElementSelections, getInitialSelections, getMessage, getOkButton, getResult, isResizable, setDialogBoundsSettings, setInitialElementSelections, setInitialSelections, setMessage, setResult, setSelectionResult, setTitle
 
Methods inherited from class org.eclipse.jface.dialogs. TrayDialog
close, closeTray, createHelpControl, getLayout, getTray, isDialogHelpAvailable, isHelpAvailable, openTray, setDialogHelpAvailable, setHelpAvailable
 
Methods inherited from class org.eclipse.jface.dialogs. Dialog
applyDialogFont, buttonPressed, convertHeightInCharsToPixels, convertHeightInCharsToPixels, convertHorizontalDLUsToPixels, convertHorizontalDLUsToPixels, convertVerticalDLUsToPixels, convertVerticalDLUsToPixels, convertWidthInCharsToPixels, convertWidthInCharsToPixels, createButton, createContents, dialogFontIsDefault, getBlockedHandler, getButton, getButtonBar, getCancelButton, getDialogArea, getImage, getInitialLocation, getInitialSize, getOKButton, initializeBounds, initializeDialogUnits, setBlockedHandler, setButtonLayoutData, setButtonLayoutFormData, shortenText
 
Methods inherited from class org.eclipse.jface.window. Window
canHandleShellCloseEvent, constrainShellSize, createShell, getConstrainedShellBounds, getContents, getDefaultImage, getDefaultImages, getDefaultOrientation, getParentShell, getReturnCode, getShell, getShellListener, getShellStyle, getWindowManager, handleFontChange, handleShellCloseEvent, setBlockOnOpen, setDefaultImage, setDefaultImages, setDefaultModalParent, setDefaultOrientation, setExceptionHandler, setParentShell, setReturnCode, setShellStyle, setWindowManager
 
Methods inherited from class java.lang. Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait
 

Constructor Detail

CheckedTreeSelectionDialog

public CheckedTreeSelectionDialog(
Shell parent,
                                  
ILabelProvider labelProvider,
                                  
ITreeContentProvider contentProvider)
Constructs an instance of ElementTreeSelectionDialog.

Parameters:
parent - The shell to parent from.
labelProvider - the label provider to render the entries
contentProvider - the content provider to evaluate the tree structure
Method Detail

setContainerMode

public void setContainerMode(boolean containerMode)
If set, the checked /gray state of containers (inner nodes) is derived from the checked state of its leaf nodes.

Parameters:
containerMode - The containerMode to set

setInitialSelection

public void setInitialSelection(
Object selection)
Sets the initial selection. Convenience method.

Parameters:
selection - the initial selection.

setEmptyListMessage

public void setEmptyListMessage(
String message)
Sets the message to be displayed if the list is empty.

Parameters:
message - the message to be displayed.

setSorter

public void setSorter(
ViewerSorter sorter)
Deprecated. since 3.3, use setComparator(ViewerComparator) instead

Sets the sorter used by the tree viewer.

Parameters:
sorter -

setComparator

public void setComparator(
ViewerComparator comparator)
Sets the comparator used by the tree viewer.

Parameters:
comparator -
Since:
3.3

addFilter

public void addFilter(
ViewerFilter filter)
Adds a filter to the tree viewer.

Parameters:
filter - a filter.

setValidator

public void setValidator(
ISelectionStatusValidator validator)
Sets an optional validator to check if the selection is valid. The validator is invoked whenever the selection changes.

Parameters:
validator - the validator to validate the selection.

setInput

public void setInput(
Object input)
Sets the tree input.

Parameters:
input - the tree input.

setExpandedElements

public void setExpandedElements(
Object[] elements)
Expands elements in the tree.

Parameters:
elements - The elements that will be expanded.

setSize

public void setSize(int width,
                    int height)
Sets the size of the tree in unit of characters.

Parameters:
width - the width of the tree.
height - the height of the tree.

updateOKStatus

protected void updateOKStatus()
Validate the receiver and update the status with the result.


open

public int open()
Description copied from class: Window
Opens this window, creating it first if it has not yet been created.

If this window has been configured to block on open ( setBlockOnOpen), this method waits until the window is closed by the end user, and then it returns the window's return code; otherwise, this method returns immediately. A window's return codes are window-specific, although two standard return codes are predefined: OK and CANCEL.

Overrides:
open in class Window
Returns:
the return code
See Also:
Window.create()

cancelPressed

protected void cancelPressed()
Handles cancel button pressed event.

Overrides:
cancelPressed in class Dialog

computeResult

protected void computeResult()
Description copied from class: SelectionStatusDialog
Compute the result and return it.

Specified by:
computeResult in class SelectionStatusDialog

create

public void create()
Description copied from class: Window
Creates this window's widgetry in a new top-level shell.

The default implementation of this framework method creates this window's shell (by calling createShell), and its controls (by calling createContents), then initializes this window's shell bounds (by calling initializeBounds).

Overrides:
create in class SelectionStatusDialog

createDialogArea

protected 
Control createDialogArea(
Composite parent)
Description copied from class: Dialog
Creates and returns the contents of the upper part of this dialog (above the button bar).

The Dialog implementation of this framework method creates and returns a new Composite with standard margins and spacing.

The returned control's layout data must be an instance of GridData. This method must not modify the parent's layout.

Subclasses must override this method but may call super as in the following example:

 Composite composite = (Composite) super.createDialogArea(parent);
 //add controls to composite as necessary
 return composite;
 

Overrides:
createDialogArea in class Dialog
Parameters:
parent - the parent composite to contain the dialog area
Returns:
the dialog area control

createTreeViewer

protected 
CheckboxTreeViewer createTreeViewer(
Composite parent)
Creates the tree viewer.

Parameters:
parent - the parent composite
Returns:
the tree viewer

getTreeViewer

protected 
CheckboxTreeViewer getTreeViewer()
Returns the tree viewer.

Returns:
the tree viewer

createSelectionButtons

protected 
Composite createSelectionButtons(
Composite composite)
Adds the selection and deselection buttons to the dialog.

Parameters:
composite - the parent composite
Returns:
Composite the composite the buttons were created in.

Eclipse Platform
Release 3.5

Guidelines for using Eclipse APIs.

Copyright (c) Eclipse contributors and others 2000, 2008. All rights reserved.


 
 
  Published under the terms of the Eclipse Public License Version 1.0 ("EPL") Design by Interspire