---

Overview  Package    Class   Use  Tree  Deprecated  Index  Help		Eclipse Platform Release 3.5
PREV CLASS    NEXT CLASS	NO FRAMES
SUMMARY:  NESTED |  FIELD |  CONSTR |  METHOD	DETAIL: FIELD |  CONSTR |  METHOD

---

org.eclipse.ui.dialogs
Class TwoPaneElementSelector

java.lang.Object
  

org.eclipse.jface.window.Window
      

org.eclipse.jface.dialogs.Dialog
          

org.eclipse.jface.dialogs.TrayDialog
              

org.eclipse.ui.dialogs.SelectionDialog
                  

org.eclipse.ui.dialogs.SelectionStatusDialog
                      

org.eclipse.ui.dialogs.AbstractElementListSelectionDialog
                          
org.eclipse.ui.dialogs.TwoPaneElementSelector

All Implemented Interfaces:

IShellProvider

---

public class TwoPaneElementSelector
extends 
AbstractElementListSelectionDialog

A list selection dialog with two panes. Duplicated entries will be folded together and are displayed in the lower pane (qualifier).

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.ui.dialogs. AbstractElementListSelectionDialog
fFilteredList

 

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
TwoPaneElementSelector ( Shell parent, ILabelProvider elementRenderer, ILabelProvider qualifierRenderer)           Creates the two pane element selector.

 

Method Summary
protected  void	computeResult ()           Compute the result and return it.
Control	createDialogArea ( Composite parent)           Creates and returns the contents of the upper part of this dialog (above the button bar).
protected   Label	createLabel ( Composite parent, String name)           Creates a label if name was not null.
protected   Table	createLowerList ( Composite parent)           Creates the list widget and sets layout data.
protected   Object	getLowerSelectedElement ()           Returns the selected element from the lower pane.
protected  void	handleDefaultSelected ()           Handles default selection (double click).
protected  void	handleEmptyList ()           Handles empty list by disabling widgets.
protected  void	handleSelectionChanged ()           Handles a selection changed event.
void	setElements ( Object[] elements)           Sets the elements to be displayed.
void	setLowerListComparator ( Comparator comparator)           Sets the comparator used to sort the list in the lower pane.
void	setLowerListLabel ( String label)           Sets the lower list label.
protected  void	setLowerSelectedElement ( Object element)           Selects an element in the lower pane.
void	setUpperListLabel ( String label)           Sets the upper list label.
protected  boolean	validateCurrentSelection ()           Validates the current selection and updates the status line accordingly.

 

Methods inherited from class org.eclipse.ui.dialogs. AbstractElementListSelectionDialog

cancelPressed, create, createFilteredList, createFilterText, createMessageArea, getFilter, getFoldedElements, getSelectedElements, getSelectionIndex, getSelectionIndices, getValidator, isCaseIgnored, open, setAllowDuplicates, setEmptyListMessage, setEmptySelectionMessage, setFilter, setIgnoreCase, setListElements, setMatchEmptyString, setMultipleSelection, setSelection, setSize, setValidator, updateOkState

 

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, 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

TwoPaneElementSelector

public TwoPaneElementSelector(
Shell parent,
                              
ILabelProvider elementRenderer,
                              
ILabelProvider qualifierRenderer)

Creates the two pane element selector.

Parameters:

parent - the parent shell.

elementRenderer - the element renderer.

qualifierRenderer - the qualifier renderer.

Method Detail

setUpperListLabel

public void setUpperListLabel(
String label)

Sets the upper list label. If the label is null (default), no label is created.

Parameters:

label -

---

setLowerListLabel

public void setLowerListLabel(
String label)

Sets the lower list label.

Parameters:

label - String or null. If the label is null (default), no label is created.

---

setLowerListComparator

public void setLowerListComparator(
Comparator comparator)

Sets the comparator used to sort the list in the lower pane.

Note: the comparator might want to honor AbstractElementListSelectionDialog.isCaseIgnored().

Parameters:

comparator - a Comparator or null if String's comparison methods should be used

Since:

3.5

---

setElements

public void setElements(
Object[] elements)

Sets the elements to be displayed.

Parameters:

elements - the elements to be displayed.

---

createDialogArea

public 
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

---

createLabel

protected 
Label createLabel(
Composite parent,
                            
String name)

Creates a label if name was not null.

Parameters:

parent - the parent composite.

name - the name of the label.

Returns:

returns a label if a name was given, null otherwise.

---

createLowerList

protected 
Table createLowerList(
Composite parent)

Creates the list widget and sets layout data.

Parameters:

parent - the parent composite.

Returns:

returns the list table widget.

---

computeResult

protected void computeResult()

Description copied from class: SelectionStatusDialog

Compute the result and return it.

Specified by:

computeResult in class SelectionStatusDialog

See Also:

SelectionStatusDialog.computeResult()

---

handleDefaultSelected

protected void handleDefaultSelected()

Description copied from class: AbstractElementListSelectionDialog

Handles default selection (double click). By default, the OK button is pressed.

Overrides:

handleDefaultSelected in class AbstractElementListSelectionDialog

See Also:

AbstractElementListSelectionDialog.handleDefaultSelected()

---

handleSelectionChanged

protected void handleSelectionChanged()

Description copied from class: AbstractElementListSelectionDialog

Handles a selection changed event. By default, the current selection is validated.

Overrides:

handleSelectionChanged in class AbstractElementListSelectionDialog

See Also:

AbstractElementListSelectionDialog.handleSelectionChanged()

---

setLowerSelectedElement

protected void setLowerSelectedElement(
Object element)

Selects an element in the lower pane.

Parameters:

element -

---

getLowerSelectedElement

protected 
Object getLowerSelectedElement()

Returns the selected element from the lower pane.

Returns:

Object

---

handleEmptyList

protected void handleEmptyList()

Description copied from class: AbstractElementListSelectionDialog

Handles empty list by disabling widgets.

Overrides:

handleEmptyList in class AbstractElementListSelectionDialog

---

validateCurrentSelection

protected boolean validateCurrentSelection()

Description copied from class: AbstractElementListSelectionDialog

Validates the current selection and updates the status line accordingly.

Overrides:

validateCurrentSelection in class AbstractElementListSelectionDialog

Returns:

boolean true if the current selection is valid.

Since:

3.5

See Also:

AbstractElementListSelectionDialog.validateCurrentSelection()

---

Overview  Package    Class   Use  Tree  Deprecated  Index  Help		Eclipse Platform Release 3.5
PREV CLASS    NEXT CLASS	NO FRAMES
SUMMARY:  NESTED |  FIELD |  CONSTR |  METHOD	DETAIL: FIELD |  CONSTR |  METHOD

---

Guidelines for using Eclipse APIs.

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