Preference Page和PropertyPage的一些相关知识.

PropertyPage实际上是继承PreferencePage的. 这个从类就可以看到.

package org.eclipse.ui.dialogs ..... public abstract class PropertyPage extends PreferencePage implements         IWorkbenchPropertyPage { }

打开PreferencePageDialog:
        PreferenceManager manager = window.getWorkbench().getPreferenceManager();
        PreferenceDialog dialog = new PreferenceDialog(window.getShell(), manager);
        dialog.open();

打开PropertyPageDialog:
        PropertyDialog dialog = PropertyDialog.createDialogOn(shell, null, element);
        dialog.open();

打开只有选定首选项页的Dialog:
                WorkbenchPreferenceDialog dialog = WorkbenchPreferenceDialog.createDialogOn(parent.getShell(), id);
                dialog.showOnly(new String[] { id });
                dialog.open();

这些都是常规方法, 应该可以满足RCP开发的基本需求了.

另外就是大家可以看到有些PropertyPage上有"Enable project specific settings" 的CheckBox和"Configure Workspace Setting"的超链. 这个其实是JDT里面带的页面, 类名应该是PreferenceAndPropertyPage. 不过因为RCP不一定会用到JDT, 所以我写了一个简单的实现, 如下:

其中StingIDEMessages是一个NLS类, 应该不用多解释了.

/**
 * Copyright 2007~2008 Brad.Wu, All rights reserved.<br>
 * Created at Jun 3, 2008 9:55:03 AM
 */
package test;

import net.sf.sting.ide.messages.StingIDEMessages;

import org.eclipse.swt.SWT;
import org.eclipse.swt.events.SelectionAdapter;
import org.eclipse.swt.events.SelectionEvent;
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.Link;
import org.eclipse.ui.IWorkbenchPropertyPage;
import org.eclipse.ui.dialogs.PropertyPage;
import org.eclipse.ui.internal.dialogs.WorkbenchPreferenceDialog;

/**
 * 关联到首选项的属性页面
 *
 * @author brad.wu
 * @since 0.1
 */
public abstract class PreferenceAndPropertyPage extends PropertyPage implements
        IWorkbenchPropertyPage {
    private Button btnEnableProjectSettings;

    /**
     * (non-Javadoc)
     *
     * @see org.eclipse.jface.preference.PreferencePage#createContents(org.eclipse.swt.widgets.Composite)
     */
    @Override
    protected final Control createContents(final Composite parent) {
        Composite container = new Composite(parent, SWT.NONE);
        container.setLayoutData(new GridData(GridData.FILL_BOTH));
        GridLayout layout = new GridLayout();
        layout.numColumns = 2;
        container.setLayout(layout);

        btnEnableProjectSettings = new Button(container, SWT.CHECK);
        btnEnableProjectSettings
                .setText(StingIDEMessages.PreferenceAndPropertyPage_enableProjectSettingsLabel);
        btnEnableProjectSettings.setLayoutData(new GridData(GridData.BEGINNING,
                GridData.CENTER, true, false, 1, 1));
        Link link = new Link(container, SWT.NONE);
        link
                .setText("<a>"
                        + StingIDEMessages.PreferenceAndPropertyPage_configWorkspaceSettingsLink
                        + "</a>");
        link.setLayoutData(new GridData(GridData.BEGINNING, GridData.CENTER,
                false, false, 1, 1));

        Label label = new Label(container, SWT.SEPARATOR | SWT.HORIZONTAL);
        label.setLayoutData(new GridData(GridData.FILL, GridData.CENTER, true,
                false, 2, 1));

        final Composite comp = new Composite(container, SWT.NONE);
        comp.setLayoutData(new GridData(GridData.FILL, GridData.FILL, true,
                true, 2, 1));
        comp.setLayout(new GridLayout());
        createCustomContents(comp);
        setEnabled(comp, false);

        btnEnableProjectSettings.addSelectionListener(new SelectionAdapter() {
            /**
             * (non-Javadoc)
             *
             * @see org.eclipse.swt.events.SelectionAdapter#widgetSelected(org.eclipse.swt.events.SelectionEvent)
             */
            @Override
            public void widgetSelected(SelectionEvent e) {
                boolean selected = btnEnableProjectSettings.getSelection();
                setEnabled(comp, selected);
            }
        });
        link.addSelectionListener(new SelectionAdapter() {
            /**
             * (non-Javadoc)
             *
             * @see org.eclipse.swt.events.SelectionAdapter#widgetSelected(org.eclipse.swt.events.SelectionEvent)
             */
            @Override
            public void widgetSelected(SelectionEvent e) {
                String id = getRelatedPreferencePageId();
                WorkbenchPreferenceDialog dialog = WorkbenchPreferenceDialog
                        .createDialogOn(parent.getShell(), id);
                dialog.showOnly(new String[] { id });
                dialog.open();
            }
        });
        return container;
    }

    /**
     * 创建组件
     *
     * @param parent
     */
    protected abstract void createCustomContents(Composite parent);

    /**
     * 获取相关的首选项页面ID
     *
     * @return
     */
    protected abstract String getRelatedPreferencePageId();

    /**
     * 获取项目设置是否已经被启用
     *
     * @return
     */
    protected boolean isProjectSettingsEnabled() {
        return btnEnableProjectSettings.getSelection();
    }

    /**
     * 设置可用性
     *
     * @param comp
     * @param selected
     */
    private void setEnabled(final Composite comp, boolean selected) {
        comp.setEnabled(selected);
        Control[] controls = comp.getChildren();
        if (controls != null) {
            for (Control control : controls) {
                control.setEnabled(selected);
                if (control instanceof Composite) {
                    setEnabled((Composite) control, selected);
                }
            }
        }
    }

    /**
     * 设置是否启用项目设置
     *
     * @param enabled
     */
    protected final void setEnableProjectSettings(boolean enabled) {
        btnEnableProjectSettings.setSelection(enabled);
    }
}