org.eclipse.tcf.te.ui.controls.interfaces.IWizardConfigurationPanel.java Source code

Introduction

Here is the source code for org.eclipse.tcf.te.ui.controls.interfaces.IWizardConfigurationPanel.java

Source

/*******************************************************************************
 * Copyright (c) 2011, 2014 Wind River Systems, Inc. and others. All rights reserved.
 * This program and the accompanying materials are made available under the terms
 * of the Eclipse Public License v1.0 which accompanies this distribution, and is
 * available at http://www.eclipse.org/legal/epl-v10.html
 *
 * Contributors:
 * Wind River Systems - initial API and implementation
 *******************************************************************************/
package org.eclipse.tcf.te.ui.controls.interfaces;

import org.eclipse.jface.dialogs.IDialogSettings;
import org.eclipse.jface.dialogs.IMessageProvider;
import org.eclipse.swt.events.TypedEvent;
import org.eclipse.swt.widgets.Composite;
import org.eclipse.tcf.te.runtime.interfaces.properties.IPropertiesContainer;
import org.eclipse.tcf.te.ui.controls.validator.Validator;
import org.eclipse.ui.forms.widgets.FormToolkit;

/**
 * Interface to deal with the replaceable wizard configuration panels.
 */
public interface IWizardConfigurationPanel extends IMessageProvider {

    /**
     * Creates the wizard configuration panel UI elements within the given parent composite.
     * Wizard configuration panels should always create another composite within the given
     * composite, which is the panel top control. The top control is queried later from the
     * stack layout to show the different panels if the backend selection is changing.
     *
     * @param parent The parent composite to create the UI elements in. Must not be <code>null</code>.
     * @param toolkit The form toolkit. Must not be <code>null</code>.
     */
    public void setupPanel(Composite parent, FormToolkit toolkit);

    /**
     * Cleanup all resources the wizard configuration panel might have been created.
     */
    public void dispose();

    /**
     * Returns the wizard configuration panels top control, typically a composite control.
     * This control is requested every time the stack layout is required to set a new top control
     * because the backend selection had been changed.
     *
     * @return The wizard configuration panels top control or <code>null</code> if the configuration panel has been not setup yet.
     */
    public Composite getControl();

    /**
     * Validates the control and sets the message text and type so the parent
     * page or control is able to display validation result informations.
     * The validation should be done by implementations of {@link Validator}!
     * The default implementation of this method does nothing.
     *
     * @return Result of validation.
     */
    public boolean isValid();

    /**
     * Called from external to query if the panel control values have changed
     * compared to the given data.
     *
     * @param data The data. Must not be <code>null</code>.
     * @param e The event which triggered the invocation or <code>null</code>.
     *
     * @return <code>True</code> if the panel control values are different to the given reference data, <code>false</code> otherwise.
     */
    public boolean dataChanged(IPropertiesContainer data, TypedEvent e);

    public String getDialogSettingsSectionName();

    /**
     * Restore the widget values plain from the given dialog settings. This method should
     * not fragment the given dialog settings any further.
     *
     * @param settings The dialog settings to restore the widget values from. Must not be <code>null</code>!
     * @param idPrefix The prefix to use for every dialog settings slot keys. If <code>null</code>, the dialog settings slot keys are not to prefix.
     */
    public void doRestoreWidgetValues(IDialogSettings settings, String idPrefix);

    /**
     * Save the widget values plain to the given dialog settings. This method should
     * not fragment the given dialog settings any further.
     *
     * @param settings The dialog settings to save the widget values to. Must not be <code>null</code>!
     * @param idPrefix The prefix to use for every dialog settings slot keys. If <code>null</code>, the dialog settings slot keys are not to prefix.
     */
    public void doSaveWidgetValues(IDialogSettings settings, String idPrefix);

    /**
     * Enables or disables all UI elements belonging to the wizard configuration panel.
     *
     * @param enabled <code>True</code> to enable the UI elements, <code>false</code> otherwise.
     */
    public void setEnabled(boolean enabled);

    /**
     * Called when the panel gets the active panel.
     */
    public void activate();
}