org.eclipse.jface.preference.FieldEditorPreferencePage Maven / Gradle / Ivy
/*******************************************************************************
* Copyright (c) 2000, 2015 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
* Chris Tilt ([email protected]) - Bug 38547 - [Preferences] Changing preferences
* ignored after "Restore defaults" pressed.
*******************************************************************************/
package org.eclipse.jface.preference;
import java.util.ArrayList;
import java.util.Iterator;
import java.util.List;
import org.eclipse.jface.resource.ImageDescriptor;
import org.eclipse.jface.util.IPropertyChangeListener;
import org.eclipse.jface.util.PropertyChangeEvent;
import org.eclipse.swt.SWT;
import org.eclipse.swt.layout.GridData;
import org.eclipse.swt.layout.GridLayout;
import org.eclipse.swt.widgets.Composite;
import org.eclipse.swt.widgets.Control;
/**
* A special abstract preference page to host field editors.
*
* Subclasses must implement the createFieldEditors
method
* and should override createLayout
if a special layout of the field
* editors is needed.
*
*/
public abstract class FieldEditorPreferencePage extends PreferencePage
implements IPropertyChangeListener {
/**
* Layout constant (value 0
) indicating that
* each field editor is handled as a single component.
*/
public static final int FLAT = 0;
/**
* Layout constant (value 1
) indicating that
* the field editors' basic controls are put into a grid layout.
*/
public static final int GRID = 1;
/**
* The vertical spacing used by layout styles FLAT
* and GRID
.
*/
protected static final int VERTICAL_SPACING = 10;
/**
* The margin width used by layout styles FLAT
* and GRID
.
*/
protected static final int MARGIN_WIDTH = 0;
/**
* The margin height used by layout styles FLAT
* and GRID
.
*/
protected static final int MARGIN_HEIGHT = 0;
/**
* The field editors, or null
if not created yet.
*/
private List fields = null;
/**
* The layout style; either FLAT
or GRID
.
*/
private int style;
/**
* The first invalid field editor, or null
* if all field editors are valid.
*/
private FieldEditor invalidFieldEditor = null;
/**
* The parent composite for field editors
*/
private Composite fieldEditorParent;
/**
* Create a new instance of the receiver.
*/
public FieldEditorPreferencePage() {
this(FLAT);
}
/**
* Creates a new field editor preference page with the given style,
* an empty title, and no image.
*
* @param style either GRID
or FLAT
*/
protected FieldEditorPreferencePage(int style) {
super();
this.style = style;
}
/**
* Creates a new field editor preference page with the given title
* and style, but no image.
*
* @param title the title of this preference page
* @param style either GRID
or FLAT
*/
protected FieldEditorPreferencePage(String title, int style) {
super(title);
this.style = style;
}
/**
* Creates a new field editor preference page with the given title,
* image, and style.
*
* @param title the title of this preference page
* @param image the image for this preference page, or
* null
if none
* @param style either GRID
or FLAT
*/
protected FieldEditorPreferencePage(String title, ImageDescriptor image,
int style) {
super(title, image);
this.style = style;
}
/**
* Adds the given field editor to this page.
*
* @param editor the field editor
*/
protected void addField(FieldEditor editor) {
if (fields == null) {
fields = new ArrayList<>();
}
fields.add(editor);
}
/**
* Adjust the layout of the field editors so that
* they are properly aligned.
*/
protected void adjustGridLayout() {
int numColumns = calcNumberOfColumns();
((GridLayout) fieldEditorParent.getLayout()).numColumns = numColumns;
if (fields != null) {
for (FieldEditor fieldEditor : fields) {
fieldEditor.adjustForNumColumns(numColumns);
}
}
}
/**
* Applys the font to the field editors managed by this page.
*/
protected void applyFont() {
if (fields != null) {
Iterator e = fields.iterator();
while (e.hasNext()) {
FieldEditor pe = e.next();
pe.applyFont();
}
}
}
/**
* Calculates the number of columns needed to host all field editors.
*
* @return the number of columns
*/
private int calcNumberOfColumns() {
int result = 0;
if (fields != null) {
Iterator e = fields.iterator();
while (e.hasNext()) {
FieldEditor pe = e.next();
result = Math.max(result, pe.getNumberOfControls());
}
}
return result;
}
/**
* Recomputes the page's error state by calling isValid
for
* every field editor.
*/
protected void checkState() {
boolean valid = true;
invalidFieldEditor = null;
// The state can only be set to true if all
// field editors contain a valid value. So we must check them all
if (fields != null) {
int size = fields.size();
for (int i = 0; i < size; i++) {
FieldEditor editor = fields.get(i);
valid = valid && editor.isValid();
if (!valid) {
invalidFieldEditor = editor;
break;
}
}
}
setValid(valid);
}
@Override
protected Control createContents(Composite parent) {
fieldEditorParent = new Composite(parent, SWT.NULL);
GridLayout layout = new GridLayout();
layout.numColumns = 1;
layout.marginHeight = 0;
layout.marginWidth = 0;
fieldEditorParent.setLayout(layout);
fieldEditorParent.setFont(parent.getFont());
createFieldEditors();
if (style == GRID) {
adjustGridLayout();
}
initialize();
checkState();
return fieldEditorParent;
}
/**
* Creates the page's field editors.
*
* The default implementation of this framework method
* does nothing. Subclass must implement this method to
* create the field editors.
*
*
* Subclasses should call getFieldEditorParent
* to obtain the parent control for each field editor.
* This same parent should not be used for more than
* one editor as the parent may change for each field
* editor depending on the layout style of the page
*
*/
protected abstract void createFieldEditors();
/**
* The field editor preference page implementation of an IDialogPage
* method disposes of this page's controls and images.
* Subclasses may override to release their own allocated SWT
* resources, but must call super.dispose
.
*/
@Override
public void dispose() {
super.dispose();
if (fields != null) {
Iterator e = fields.iterator();
while (e.hasNext()) {
FieldEditor pe = e.next();
pe.setPage(null);
pe.setPropertyChangeListener(null);
pe.setPreferenceStore(null);
}
}
}
/**
* Returns a parent composite for a field editor.
*
* This value must not be cached since a new parent
* may be created each time this method called. Thus
* this method must be called each time a field editor
* is constructed.
*
*
* @return a parent
*/
protected Composite getFieldEditorParent() {
if (style == FLAT) {
// Create a new parent for each field editor
Composite parent = new Composite(fieldEditorParent, SWT.NULL);
parent.setLayoutData(new GridData(GridData.FILL_HORIZONTAL));
return parent;
}
// Just return the parent
return fieldEditorParent;
}
/**
* Initializes all field editors.
*/
protected void initialize() {
if (fields != null) {
Iterator e = fields.iterator();
while (e.hasNext()) {
FieldEditor pe = e.next();
pe.setPage(this);
pe.setPropertyChangeListener(this);
if (pe.getPreferenceStore() == null) {
pe.setPreferenceStore(getPreferenceStore());
}
pe.load();
}
}
}
/**
* The field editor preference page implementation of a PreferencePage
* method loads all the field editors with their default values.
*/
@Override
protected void performDefaults() {
if (fields != null) {
Iterator e = fields.iterator();
while (e.hasNext()) {
FieldEditor pe = e.next();
pe.loadDefault();
}
}
// Force a recalculation of my error state.
checkState();
super.performDefaults();
}
/**
* The field editor preference page implementation of this
* PreferencePage
method saves all field editors by
* calling FieldEditor.store
. Note that this method
* does not save the preference store itself; it just stores the
* values back into the preference store.
*
* @see FieldEditor#store()
*/
@Override
public boolean performOk() {
if (fields != null) {
Iterator e = fields.iterator();
while (e.hasNext()) {
FieldEditor pe = e.next();
pe.store();
pe.setPresentsDefaultValue(false);
}
}
return true;
}
/**
* The field editor preference page implementation of this IPreferencePage
* (and IPropertyChangeListener
) method intercepts IS_VALID
* events but passes other events on to its superclass.
*/
@Override
public void propertyChange(PropertyChangeEvent event) {
if (event.getProperty().equals(FieldEditor.IS_VALID)) {
boolean newValue = ((Boolean) event.getNewValue()).booleanValue();
// If the new value is true then we must check all field editors.
// If it is false, then the page is invalid in any case.
if (newValue) {
checkState();
} else {
invalidFieldEditor = (FieldEditor) event.getSource();
setValid(newValue);
}
}
}
@Override
public void setVisible(boolean visible) {
super.setVisible(visible);
if (visible && invalidFieldEditor != null) {
invalidFieldEditor.setFocus();
}
}
}