core/org.eclipse.cdt.ui/src/org/eclipse/cdt/internal/ui/filters/CustomFiltersDialog.java - cdt/org.eclipse.cdt - Git at Google

 /*******************************************************************************
  * Copyright (c) 2000, 2016 IBM Corporation and others.
  *
  * This program and the accompanying materials
  * are made available under the terms of the Eclipse Public License 2.0
  * which accompanies this distribution, and is available at
  * https://www.eclipse.org/legal/epl-2.0/
  *
  * SPDX-License-Identifier: EPL-2.0
  *
  * Contributors:
  *     IBM Corporation - initial API and implementation
  *******************************************************************************/
 package org.eclipse.cdt.internal.ui.filters;

 import java.util.ArrayList;
 import java.util.Arrays;
 import java.util.HashSet;
 import java.util.Iterator;
 import java.util.List;
 import java.util.Set;
 import java.util.Stack;
 import java.util.StringTokenizer;

 import org.eclipse.cdt.internal.ui.ICHelpContextIds;
 import org.eclipse.cdt.internal.ui.util.SWTUtil;
 import org.eclipse.core.runtime.Assert;
 import org.eclipse.jface.dialogs.IDialogConstants;
 import org.eclipse.jface.viewers.ArrayContentProvider;
 import org.eclipse.jface.viewers.CheckStateChangedEvent;
 import org.eclipse.jface.viewers.CheckboxTableViewer;
 import org.eclipse.jface.viewers.ICheckStateListener;
 import org.eclipse.jface.viewers.ILabelProvider;
 import org.eclipse.jface.viewers.ISelection;
 import org.eclipse.jface.viewers.ISelectionChangedListener;
 import org.eclipse.jface.viewers.IStructuredSelection;
 import org.eclipse.jface.viewers.LabelProvider;
 import org.eclipse.jface.viewers.SelectionChangedEvent;
 import org.eclipse.swt.SWT;
 import org.eclipse.swt.accessibility.AccessibleAdapter;
 import org.eclipse.swt.accessibility.AccessibleEvent;
 import org.eclipse.swt.events.SelectionAdapter;
 import org.eclipse.swt.events.SelectionEvent;
 import org.eclipse.swt.events.SelectionListener;
 import org.eclipse.swt.graphics.Image;
 import org.eclipse.swt.layout.GridData;
 import org.eclipse.swt.layout.GridLayout;
 import org.eclipse.swt.widgets.Button;
 import org.eclipse.swt.widgets.Composite;
 import org.eclipse.swt.widgets.Control;
 import org.eclipse.swt.widgets.Label;
 import org.eclipse.swt.widgets.Shell;
 import org.eclipse.swt.widgets.Text;
 import org.eclipse.ui.PlatformUI;
 import org.eclipse.ui.dialogs.SelectionDialog;

 public class CustomFiltersDialog extends SelectionDialog {

 	private static final String SEPARATOR = ","; //$NON-NLS-1$

 	private String fViewId;
 	private boolean fEnablePatterns;
 	private String[] fPatterns;
 	private String[] fEnabledFilterIds;

 	FilterDescriptor[] fBuiltInFilters;

 	CheckboxTableViewer fCheckBoxList;
 	Button fEnableUserDefinedPatterns;
 	Text fUserDefinedPatterns;

 	Stack<FilterDescriptor> fFilterDescriptorChangeHistory;

 	/**
 	 * Creates a dialog to customize Java element filters.
 	 *
 	 * @param shell the parent shell
 	 */
 	public CustomFiltersDialog(Shell shell, String viewId, boolean enablePatterns, String[] patterns,
 			String[] enabledFilterIds) {

 		super(shell);
 		Assert.isNotNull(viewId);
 		Assert.isNotNull(patterns);
 		Assert.isNotNull(enabledFilterIds);

 		fViewId = viewId;
 		fPatterns = patterns;
 		fEnablePatterns = enablePatterns;
 		fEnabledFilterIds = enabledFilterIds;

 		fBuiltInFilters = FilterDescriptor.getFilterDescriptors(fViewId);
 		fFilterDescriptorChangeHistory = new Stack<>();
 		setShellStyle(getShellStyle() | SWT.RESIZE);
 	}

 	@Override
 	protected void configureShell(Shell shell) {
 		setTitle(FilterMessages.CustomFiltersDialog_title);
 		setMessage(FilterMessages.CustomFiltersDialog_filterList_label);
 		super.configureShell(shell);
 		PlatformUI.getWorkbench().getHelpSystem().setHelp(shell, ICHelpContextIds.CUSTOM_FILTERS_DIALOG);
 	}

 	/**
 	 * Overrides method in Dialog
 	 *
 	 * @see org.eclipse.jface.dialogs.Dialog#createDialogArea(Composite)
 	 */
 	@Override
 	protected Control createDialogArea(Composite parent) {
 		initializeDialogUnits(parent);
 		// create a composite with standard margins and spacing
 		Composite composite = new Composite(parent, SWT.NONE);
 		GridLayout layout = new GridLayout();
 		layout.marginHeight = convertVerticalDLUsToPixels(IDialogConstants.VERTICAL_MARGIN);
 		layout.marginWidth = convertHorizontalDLUsToPixels(IDialogConstants.HORIZONTAL_MARGIN);
 		layout.verticalSpacing = convertVerticalDLUsToPixels(IDialogConstants.VERTICAL_SPACING);
 		layout.horizontalSpacing = convertHorizontalDLUsToPixels(IDialogConstants.HORIZONTAL_SPACING);
 		composite.setLayout(layout);
 		composite.setLayoutData(new GridData(GridData.FILL_BOTH));
 		composite.setFont(parent.getFont());
 		Composite group = composite;

 		// Checkbox
 		fEnableUserDefinedPatterns = new Button(group, SWT.CHECK);
 		fEnableUserDefinedPatterns.setText(FilterMessages.CustomFiltersDialog_enableUserDefinedPattern);

 		// Pattern	field
 		fUserDefinedPatterns = new Text(group, SWT.SINGLE | SWT.BORDER);
 		GridData data = new GridData(GridData.HORIZONTAL_ALIGN_FILL | GridData.GRAB_HORIZONTAL);
 		data.widthHint = convertWidthInCharsToPixels(59);
 		fUserDefinedPatterns.setLayoutData(data);
 		String patterns = convertToString(fPatterns, SEPARATOR);
 		fUserDefinedPatterns.setText(patterns);

 		// Info text
 		final Label info = new Label(group, SWT.LEFT);
 		info.setText(FilterMessages.CustomFiltersDialog_patternInfo);

 		// Enabling / disabling of pattern group
 		fEnableUserDefinedPatterns.setSelection(fEnablePatterns);
 		fUserDefinedPatterns.setEnabled(fEnablePatterns);
 		info.setEnabled(fEnablePatterns);
 		fEnableUserDefinedPatterns.addSelectionListener(new SelectionAdapter() {
 			@Override
 			public void widgetSelected(SelectionEvent e) {
 				boolean state = fEnableUserDefinedPatterns.getSelection();
 				fUserDefinedPatterns.setEnabled(state);
 				info.setEnabled(fEnableUserDefinedPatterns.getSelection());
 				if (state)
 					fUserDefinedPatterns.setFocus();
 			}
 		});

 		// Filters provided by extension point
 		if (fBuiltInFilters.length > 0)
 			createCheckBoxList(group);

 		applyDialogFont(parent);
 		return parent;
 	}

 	private void createCheckBoxList(Composite parent) {
 		// Filler
 		new Label(parent, SWT.NONE);

 		Label info = new Label(parent, SWT.LEFT);
 		info.setText(FilterMessages.CustomFiltersDialog_filterList_label);

 		fCheckBoxList = CheckboxTableViewer.newCheckList(parent, SWT.BORDER);
 		GridData data = new GridData(GridData.FILL_BOTH);
 		data.heightHint = fCheckBoxList.getTable().getItemHeight() * 10;
 		fCheckBoxList.getTable().setLayoutData(data);

 		fCheckBoxList.setLabelProvider(createLabelPrivder());
 		fCheckBoxList.setContentProvider(ArrayContentProvider.getInstance());

 		fCheckBoxList.setInput(fBuiltInFilters);
 		setInitialSelections(getEnabledFilterDescriptors());

 		List<?> initialSelection = getInitialElementSelections();
 		if (initialSelection != null && !initialSelection.isEmpty())
 			checkInitialSelections();

 		fCheckBoxList.getTable().getAccessible().addAccessibleListener(new AccessibleAdapter() {
 			@Override
 			public void getName(AccessibleEvent e) {
 				e.result = FilterMessages.CustomFiltersDialog_filterList_label;
 			}
 		});
 		fCheckBoxList.getTable().setToolTipText(FilterMessages.CustomFiltersDialog_filterList_label);

 		// Description
 		info = new Label(parent, SWT.LEFT);
 		info.setText(FilterMessages.CustomFiltersDialog_description_label);
 		final Text description = new Text(parent,
 				SWT.LEFT | SWT.WRAP | SWT.MULTI | SWT.READ_ONLY | SWT.BORDER | SWT.VERTICAL);
 		data = new GridData(GridData.FILL_HORIZONTAL);
 		data.heightHint = convertHeightInCharsToPixels(3);
 		description.setLayoutData(data);
 		fCheckBoxList.addSelectionChangedListener(new ISelectionChangedListener() {
 			@Override
 			public void selectionChanged(SelectionChangedEvent event) {
 				ISelection selection = event.getSelection();
 				if (selection instanceof IStructuredSelection) {
 					Object selectedElement = ((IStructuredSelection) selection).getFirstElement();
 					if (selectedElement instanceof FilterDescriptor)
 						description.setText(((FilterDescriptor) selectedElement).getDescription());
 				}
 			}
 		});
 		fCheckBoxList.addCheckStateListener(new ICheckStateListener() {
 			/*
 			 * @see org.eclipse.jface.viewers.ICheckStateListener#checkStateChanged(org.eclipse.jface.viewers.CheckStateChangedEvent)
 			 */
 			@Override
 			public void checkStateChanged(CheckStateChangedEvent event) {
 				Object element = event.getElement();
 				if (element instanceof FilterDescriptor) {
 					// renew if already touched
 					if (fFilterDescriptorChangeHistory.contains(element)) {
 						fFilterDescriptorChangeHistory.remove(element);
 					}
 					fFilterDescriptorChangeHistory.push((FilterDescriptor) element);
 				}
 			}
 		});

 		addSelectionButtons(parent);
 	}

 	private void addSelectionButtons(Composite composite) {
 		Composite buttonComposite = new Composite(composite, SWT.RIGHT);
 		GridLayout layout = new GridLayout();
 		layout.numColumns = 2;
 		buttonComposite.setLayout(layout);
 		GridData data = new GridData(GridData.HORIZONTAL_ALIGN_END | GridData.GRAB_HORIZONTAL);
 		data.grabExcessHorizontalSpace = true;
 		composite.setData(data);

 		// Select All button
 		String label = FilterMessages.CustomFiltersDialog_SelectAllButton_label;
 		Button selectButton = createButton(buttonComposite, IDialogConstants.SELECT_ALL_ID, label, false);
 		SWTUtil.setButtonDimensionHint(selectButton);
 		SelectionListener listener = new SelectionAdapter() {
 			@Override
 			public void widgetSelected(SelectionEvent e) {
 				fCheckBoxList.setAllChecked(true);
 				fFilterDescriptorChangeHistory.clear();
 				for (FilterDescriptor builtInFilter : fBuiltInFilters) {
 					fFilterDescriptorChangeHistory.push(builtInFilter);
 				}
 			}
 		};
 		selectButton.addSelectionListener(listener);

 		// Deselect All button
 		label = FilterMessages.CustomFiltersDialog_DeselectAllButton_label;
 		Button deselectButton = createButton(buttonComposite, IDialogConstants.DESELECT_ALL_ID, label, false);
 		SWTUtil.setButtonDimensionHint(deselectButton);
 		listener = new SelectionAdapter() {
 			@Override
 			public void widgetSelected(SelectionEvent e) {
 				fCheckBoxList.setAllChecked(false);
 				fFilterDescriptorChangeHistory.clear();
 				for (FilterDescriptor builtInFilter : fBuiltInFilters)
 					fFilterDescriptorChangeHistory.push(builtInFilter);
 			}
 		};
 		deselectButton.addSelectionListener(listener);
 	}

 	private void checkInitialSelections() {
 		Iterator<?> itemsToCheck = getInitialElementSelections().iterator();
 		while (itemsToCheck.hasNext())
 			fCheckBoxList.setChecked(itemsToCheck.next(), true);
 	}

 	@Override
 	protected void okPressed() {
 		if (fBuiltInFilters != null) {
 			ArrayList<FilterDescriptor> result = new ArrayList<>();
 			for (int i = 0; i < fBuiltInFilters.length; ++i) {
 				if (fCheckBoxList.getChecked(fBuiltInFilters[i]))
 					result.add(fBuiltInFilters[i]);
 			}
 			setResult(result);
 		}
 		super.okPressed();
 	}

 	private ILabelProvider createLabelPrivder() {
 		return new LabelProvider() {
 			@Override
 			public Image getImage(Object element) {
 				return null;
 			}

 			@Override
 			public String getText(Object element) {
 				if (element instanceof FilterDescriptor)
 					return ((FilterDescriptor) element).getName();
 				return null;
 			}
 		};
 	}

 	// ---------- result handling ----------

 	@SuppressWarnings("rawtypes")
 	@Override
 	protected void setResult(List newResult) {
 		super.setResult(newResult);
 		if (fUserDefinedPatterns.getText().length() > 0) {
 			fEnablePatterns = fEnableUserDefinedPatterns.getSelection();
 			fPatterns = convertFromString(fUserDefinedPatterns.getText(), SEPARATOR);
 		} else {
 			fEnablePatterns = false;
 			fPatterns = new String[0];
 		}
 	}

 	/**
 	 * @return the patterns which have been entered by the user
 	 */
 	public String[] getUserDefinedPatterns() {
 		return fPatterns;
 	}

 	/**
 	 * @return the ids of the enabled built-in filters
 	 */
 	public String[] getEnabledFilterIds() {
 		Object[] result = getResult();
 		Set<String> enabledIds = new HashSet<>(result.length);
 		for (Object element : result)
 			enabledIds.add(((FilterDescriptor) element).getId());
 		return enabledIds.toArray(new String[enabledIds.size()]);
 	}

 	/**
 	 * @return <code>true</code> if the user-defined patterns are disabled
 	 */
 	public boolean areUserDefinedPatternsEnabled() {
 		return fEnablePatterns;
 	}

 	/**
 	 * @return a stack with the filter descriptor check history
 	 * @since 3.0
 	 */
 	public Stack<FilterDescriptor> getFilterDescriptorChangeHistory() {
 		return fFilterDescriptorChangeHistory;
 	}

 	private FilterDescriptor[] getEnabledFilterDescriptors() {
 		FilterDescriptor[] filterDescs = fBuiltInFilters;
 		List<FilterDescriptor> result = new ArrayList<>(filterDescs.length);
 		List<String> enabledFilterIds = Arrays.asList(fEnabledFilterIds);
 		for (FilterDescriptor filterDesc : filterDescs) {
 			String id = filterDesc.getId();
 			if (enabledFilterIds.contains(id))
 				result.add(filterDesc);
 		}
 		return result.toArray(new FilterDescriptor[result.size()]);
 	}

 	public static String[] convertFromString(String patterns, String separator) {
 		StringTokenizer tokenizer = new StringTokenizer(patterns, separator);
 		String[] result = new String[tokenizer.countTokens()];
 		for (int i = 0; i < result.length; i++)
 			result[i] = tokenizer.nextToken().trim();
 		return result;
 	}

 	public static String convertToString(String[] patterns, String separator) {
 		int length = patterns.length;
 		StringBuilder strBuf = new StringBuilder();
 		if (length > 0)
 			strBuf.append(patterns[0]);
 		else
 			return ""; //$NON-NLS-1$
 		int i = 1;
 		while (i < length) {
 			strBuf.append(separator);
 			strBuf.append(" "); //$NON-NLS-1$
 			strBuf.append(patterns[i++]);
 		}
 		return strBuf.toString();
 	}
 }
	/*******************************************************************************
	* Copyright (c) 2000, 2016 IBM Corporation and others.
	*
	* This program and the accompanying materials
	* are made available under the terms of the Eclipse Public License 2.0
	* which accompanies this distribution, and is available at
	* https://www.eclipse.org/legal/epl-2.0/
	*
	* SPDX-License-Identifier: EPL-2.0
	*
	* Contributors:
	* IBM Corporation - initial API and implementation
	*******************************************************************************/
	package org.eclipse.cdt.internal.ui.filters;

	import java.util.ArrayList;
	import java.util.Arrays;
	import java.util.HashSet;
	import java.util.Iterator;
	import java.util.List;
	import java.util.Set;
	import java.util.Stack;
	import java.util.StringTokenizer;

	import org.eclipse.cdt.internal.ui.ICHelpContextIds;
	import org.eclipse.cdt.internal.ui.util.SWTUtil;
	import org.eclipse.core.runtime.Assert;
	import org.eclipse.jface.dialogs.IDialogConstants;
	import org.eclipse.jface.viewers.ArrayContentProvider;
	import org.eclipse.jface.viewers.CheckStateChangedEvent;
	import org.eclipse.jface.viewers.CheckboxTableViewer;
	import org.eclipse.jface.viewers.ICheckStateListener;
	import org.eclipse.jface.viewers.ILabelProvider;
	import org.eclipse.jface.viewers.ISelection;
	import org.eclipse.jface.viewers.ISelectionChangedListener;
	import org.eclipse.jface.viewers.IStructuredSelection;
	import org.eclipse.jface.viewers.LabelProvider;
	import org.eclipse.jface.viewers.SelectionChangedEvent;
	import org.eclipse.swt.SWT;
	import org.eclipse.swt.accessibility.AccessibleAdapter;
	import org.eclipse.swt.accessibility.AccessibleEvent;
	import org.eclipse.swt.events.SelectionAdapter;
	import org.eclipse.swt.events.SelectionEvent;
	import org.eclipse.swt.events.SelectionListener;
	import org.eclipse.swt.graphics.Image;
	import org.eclipse.swt.layout.GridData;
	import org.eclipse.swt.layout.GridLayout;
	import org.eclipse.swt.widgets.Button;
	import org.eclipse.swt.widgets.Composite;
	import org.eclipse.swt.widgets.Control;
	import org.eclipse.swt.widgets.Label;
	import org.eclipse.swt.widgets.Shell;
	import org.eclipse.swt.widgets.Text;
	import org.eclipse.ui.PlatformUI;
	import org.eclipse.ui.dialogs.SelectionDialog;

	public class CustomFiltersDialog extends SelectionDialog {

	private static final String SEPARATOR = ","; //$NON-NLS-1$

	private String fViewId;
	private boolean fEnablePatterns;
	private String[] fPatterns;
	private String[] fEnabledFilterIds;

	FilterDescriptor[] fBuiltInFilters;

	CheckboxTableViewer fCheckBoxList;
	Button fEnableUserDefinedPatterns;
	Text fUserDefinedPatterns;

	Stack<FilterDescriptor> fFilterDescriptorChangeHistory;

	/**
	* Creates a dialog to customize Java element filters.
	*
	* @param shell the parent shell
	*/
	public CustomFiltersDialog(Shell shell, String viewId, boolean enablePatterns, String[] patterns,
	String[] enabledFilterIds) {

	super(shell);
	Assert.isNotNull(viewId);
	Assert.isNotNull(patterns);
	Assert.isNotNull(enabledFilterIds);

	fViewId = viewId;
	fPatterns = patterns;
	fEnablePatterns = enablePatterns;
	fEnabledFilterIds = enabledFilterIds;

	fBuiltInFilters = FilterDescriptor.getFilterDescriptors(fViewId);
	fFilterDescriptorChangeHistory = new Stack<>();
	setShellStyle(getShellStyle() \| SWT.RESIZE);
	}

	@Override
	protected void configureShell(Shell shell) {
	setTitle(FilterMessages.CustomFiltersDialog_title);
	setMessage(FilterMessages.CustomFiltersDialog_filterList_label);
	super.configureShell(shell);
	PlatformUI.getWorkbench().getHelpSystem().setHelp(shell, ICHelpContextIds.CUSTOM_FILTERS_DIALOG);
	}

	/**
	* Overrides method in Dialog
	*
	* @see org.eclipse.jface.dialogs.Dialog#createDialogArea(Composite)
	*/
	@Override
	protected Control createDialogArea(Composite parent) {
	initializeDialogUnits(parent);
	// create a composite with standard margins and spacing
	Composite composite = new Composite(parent, SWT.NONE);
	GridLayout layout = new GridLayout();
	layout.marginHeight = convertVerticalDLUsToPixels(IDialogConstants.VERTICAL_MARGIN);
	layout.marginWidth = convertHorizontalDLUsToPixels(IDialogConstants.HORIZONTAL_MARGIN);
	layout.verticalSpacing = convertVerticalDLUsToPixels(IDialogConstants.VERTICAL_SPACING);
	layout.horizontalSpacing = convertHorizontalDLUsToPixels(IDialogConstants.HORIZONTAL_SPACING);
	composite.setLayout(layout);
	composite.setLayoutData(new GridData(GridData.FILL_BOTH));
	composite.setFont(parent.getFont());
	Composite group = composite;

	// Checkbox
	fEnableUserDefinedPatterns = new Button(group, SWT.CHECK);
	fEnableUserDefinedPatterns.setText(FilterMessages.CustomFiltersDialog_enableUserDefinedPattern);

	// Pattern field
	fUserDefinedPatterns = new Text(group, SWT.SINGLE \| SWT.BORDER);
	GridData data = new GridData(GridData.HORIZONTAL_ALIGN_FILL \| GridData.GRAB_HORIZONTAL);
	data.widthHint = convertWidthInCharsToPixels(59);
	fUserDefinedPatterns.setLayoutData(data);
	String patterns = convertToString(fPatterns, SEPARATOR);
	fUserDefinedPatterns.setText(patterns);

	// Info text
	final Label info = new Label(group, SWT.LEFT);
	info.setText(FilterMessages.CustomFiltersDialog_patternInfo);

	// Enabling / disabling of pattern group
	fEnableUserDefinedPatterns.setSelection(fEnablePatterns);
	fUserDefinedPatterns.setEnabled(fEnablePatterns);
	info.setEnabled(fEnablePatterns);
	fEnableUserDefinedPatterns.addSelectionListener(new SelectionAdapter() {
	@Override
	public void widgetSelected(SelectionEvent e) {
	boolean state = fEnableUserDefinedPatterns.getSelection();
	fUserDefinedPatterns.setEnabled(state);
	info.setEnabled(fEnableUserDefinedPatterns.getSelection());
	if (state)
	fUserDefinedPatterns.setFocus();
	}
	});

	// Filters provided by extension point
	if (fBuiltInFilters.length > 0)
	createCheckBoxList(group);

	applyDialogFont(parent);
	return parent;
	}

	private void createCheckBoxList(Composite parent) {
	// Filler
	new Label(parent, SWT.NONE);

	Label info = new Label(parent, SWT.LEFT);
	info.setText(FilterMessages.CustomFiltersDialog_filterList_label);

	fCheckBoxList = CheckboxTableViewer.newCheckList(parent, SWT.BORDER);
	GridData data = new GridData(GridData.FILL_BOTH);
	data.heightHint = fCheckBoxList.getTable().getItemHeight() * 10;
	fCheckBoxList.getTable().setLayoutData(data);

	fCheckBoxList.setLabelProvider(createLabelPrivder());
	fCheckBoxList.setContentProvider(ArrayContentProvider.getInstance());

	fCheckBoxList.setInput(fBuiltInFilters);
	setInitialSelections(getEnabledFilterDescriptors());

	List<?> initialSelection = getInitialElementSelections();
	if (initialSelection != null && !initialSelection.isEmpty())
	checkInitialSelections();

	fCheckBoxList.getTable().getAccessible().addAccessibleListener(new AccessibleAdapter() {
	@Override
	public void getName(AccessibleEvent e) {
	e.result = FilterMessages.CustomFiltersDialog_filterList_label;
	}
	});
	fCheckBoxList.getTable().setToolTipText(FilterMessages.CustomFiltersDialog_filterList_label);

	// Description
	info = new Label(parent, SWT.LEFT);
	info.setText(FilterMessages.CustomFiltersDialog_description_label);
	final Text description = new Text(parent,
	SWT.LEFT \| SWT.WRAP \| SWT.MULTI \| SWT.READ_ONLY \| SWT.BORDER \| SWT.VERTICAL);
	data = new GridData(GridData.FILL_HORIZONTAL);
	data.heightHint = convertHeightInCharsToPixels(3);
	description.setLayoutData(data);
	fCheckBoxList.addSelectionChangedListener(new ISelectionChangedListener() {
	@Override
	public void selectionChanged(SelectionChangedEvent event) {
	ISelection selection = event.getSelection();
	if (selection instanceof IStructuredSelection) {
	Object selectedElement = ((IStructuredSelection) selection).getFirstElement();
	if (selectedElement instanceof FilterDescriptor)
	description.setText(((FilterDescriptor) selectedElement).getDescription());
	}
	}
	});
	fCheckBoxList.addCheckStateListener(new ICheckStateListener() {
	/*
	* @see org.eclipse.jface.viewers.ICheckStateListener#checkStateChanged(org.eclipse.jface.viewers.CheckStateChangedEvent)
	*/
	@Override
	public void checkStateChanged(CheckStateChangedEvent event) {
	Object element = event.getElement();
	if (element instanceof FilterDescriptor) {
	// renew if already touched
	if (fFilterDescriptorChangeHistory.contains(element)) {
	fFilterDescriptorChangeHistory.remove(element);
	}
	fFilterDescriptorChangeHistory.push((FilterDescriptor) element);
	}
	}
	});

	addSelectionButtons(parent);
	}

	private void addSelectionButtons(Composite composite) {
	Composite buttonComposite = new Composite(composite, SWT.RIGHT);
	GridLayout layout = new GridLayout();
	layout.numColumns = 2;
	buttonComposite.setLayout(layout);
	GridData data = new GridData(GridData.HORIZONTAL_ALIGN_END \| GridData.GRAB_HORIZONTAL);
	data.grabExcessHorizontalSpace = true;
	composite.setData(data);

	// Select All button
	String label = FilterMessages.CustomFiltersDialog_SelectAllButton_label;
	Button selectButton = createButton(buttonComposite, IDialogConstants.SELECT_ALL_ID, label, false);
	SWTUtil.setButtonDimensionHint(selectButton);
	SelectionListener listener = new SelectionAdapter() {
	@Override
	public void widgetSelected(SelectionEvent e) {
	fCheckBoxList.setAllChecked(true);
	fFilterDescriptorChangeHistory.clear();
	for (FilterDescriptor builtInFilter : fBuiltInFilters) {
	fFilterDescriptorChangeHistory.push(builtInFilter);
	}
	}
	};
	selectButton.addSelectionListener(listener);

	// Deselect All button
	label = FilterMessages.CustomFiltersDialog_DeselectAllButton_label;
	Button deselectButton = createButton(buttonComposite, IDialogConstants.DESELECT_ALL_ID, label, false);
	SWTUtil.setButtonDimensionHint(deselectButton);
	listener = new SelectionAdapter() {
	@Override
	public void widgetSelected(SelectionEvent e) {
	fCheckBoxList.setAllChecked(false);
	fFilterDescriptorChangeHistory.clear();
	for (FilterDescriptor builtInFilter : fBuiltInFilters)
	fFilterDescriptorChangeHistory.push(builtInFilter);
	}
	};
	deselectButton.addSelectionListener(listener);
	}

	private void checkInitialSelections() {
	Iterator<?> itemsToCheck = getInitialElementSelections().iterator();
	while (itemsToCheck.hasNext())
	fCheckBoxList.setChecked(itemsToCheck.next(), true);
	}

	@Override
	protected void okPressed() {
	if (fBuiltInFilters != null) {
	ArrayList<FilterDescriptor> result = new ArrayList<>();
	for (int i = 0; i < fBuiltInFilters.length; ++i) {
	if (fCheckBoxList.getChecked(fBuiltInFilters[i]))
	result.add(fBuiltInFilters[i]);
	}
	setResult(result);
	}
	super.okPressed();
	}

	private ILabelProvider createLabelPrivder() {
	return new LabelProvider() {
	@Override
	public Image getImage(Object element) {
	return null;
	}

	@Override
	public String getText(Object element) {
	if (element instanceof FilterDescriptor)
	return ((FilterDescriptor) element).getName();
	return null;
	}
	};
	}

	// ---------- result handling ----------

	@SuppressWarnings("rawtypes")
	@Override
	protected void setResult(List newResult) {
	super.setResult(newResult);
	if (fUserDefinedPatterns.getText().length() > 0) {
	fEnablePatterns = fEnableUserDefinedPatterns.getSelection();
	fPatterns = convertFromString(fUserDefinedPatterns.getText(), SEPARATOR);
	} else {
	fEnablePatterns = false;
	fPatterns = new String[0];
	}
	}

	/**
	* @return the patterns which have been entered by the user
	*/
	public String[] getUserDefinedPatterns() {
	return fPatterns;
	}

	/**
	* @return the ids of the enabled built-in filters
	*/
	public String[] getEnabledFilterIds() {
	Object[] result = getResult();
	Set<String> enabledIds = new HashSet<>(result.length);
	for (Object element : result)
	enabledIds.add(((FilterDescriptor) element).getId());
	return enabledIds.toArray(new String[enabledIds.size()]);
	}

	/**
	* @return <code>true</code> if the user-defined patterns are disabled
	*/
	public boolean areUserDefinedPatternsEnabled() {
	return fEnablePatterns;
	}

	/**
	* @return a stack with the filter descriptor check history
	* @since 3.0
	*/
	public Stack<FilterDescriptor> getFilterDescriptorChangeHistory() {
	return fFilterDescriptorChangeHistory;
	}

	private FilterDescriptor[] getEnabledFilterDescriptors() {
	FilterDescriptor[] filterDescs = fBuiltInFilters;
	List<FilterDescriptor> result = new ArrayList<>(filterDescs.length);
	List<String> enabledFilterIds = Arrays.asList(fEnabledFilterIds);
	for (FilterDescriptor filterDesc : filterDescs) {
	String id = filterDesc.getId();
	if (enabledFilterIds.contains(id))
	result.add(filterDesc);
	}
	return result.toArray(new FilterDescriptor[result.size()]);
	}

	public static String[] convertFromString(String patterns, String separator) {
	StringTokenizer tokenizer = new StringTokenizer(patterns, separator);
	String[] result = new String[tokenizer.countTokens()];
	for (int i = 0; i < result.length; i++)
	result[i] = tokenizer.nextToken().trim();
	return result;
	}

	public static String convertToString(String[] patterns, String separator) {
	int length = patterns.length;
	StringBuilder strBuf = new StringBuilder();
	if (length > 0)
	strBuf.append(patterns[0]);
	else
	return ""; //$NON-NLS-1$
	int i = 1;
	while (i < length) {
	strBuf.append(separator);
	strBuf.append(" "); //$NON-NLS-1$
	strBuf.append(patterns[i++]);
	}
	return strBuf.toString();
	}
	}