/*
* Copyright (C) 2009 The Android Open Source Project
*
* Licensed under the Eclipse Public License, Version 1.0 (the "License");
* you may not use this file except in compliance with the License.
* You may obtain a copy of the License at
*
* http://www.eclipse.org/org/documents/epl-v10.php
*
* Unless required by applicable law or agreed to in writing, software
* distributed under the License is distributed on an "AS IS" BASIS,
* WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
* See the License for the specific language governing permissions and
* limitations under the License.
*/
package com.android.ide.eclipse.adt.internal.editors.layout;
import com.android.ide.eclipse.adt.internal.editors.layout.parts.ElementCreateCommand;
import com.android.ide.eclipse.adt.internal.editors.uimodel.UiDocumentNode;
import com.android.ide.eclipse.adt.internal.editors.uimodel.UiElementNode;
import org.eclipse.core.resources.IFile;
import org.eclipse.gef.ui.parts.SelectionSynchronizer;
import org.eclipse.swt.dnd.Clipboard;
import org.eclipse.ui.IEditorPart;
/**
* Interface defining what {@link LayoutEditor} expects from a GraphicalLayoutEditor part.
*
* @since GLE2
*/
public interface IGraphicalLayoutEditor extends IEditorPart {
/**
* Opens and initialize the editor with a new file.
* @param file the file being edited.
*/
abstract void openFile(IFile file);
/**
* Resets the editor with a replacement file.
* @param file the replacement file.
*/
abstract void replaceFile(IFile file);
/**
* Resets the editor with a replacement file coming from a config change in the config
* selector.
* @param file the replacement file.
*/
abstract void changeFileOnNewConfig(IFile file);
/**
* Responds to a target change for the project of the edited file
*/
abstract void onTargetChange();
/**
* Responds to an SDK reload/change.
*/
abstract void onSdkChange();
/**
* Callback for XML model changed. Only update/recompute the layout if the editor is visible
*/
abstract void onXmlModelChanged();
/**
* Responds to a page change that made the Graphical editor page the activated page.
*/
abstract void activated();
/**
* Responds to a page change that made the Graphical editor page the deactivated page
*/
abstract void deactivated();
/**
* Used by LayoutEditor.UiEditorActions.selectUiNode to select a new UI Node
* created by {@link ElementCreateCommand#execute()}.
*
* @param uiNodeModel The {@link UiElementNode} to select.
*/
abstract void selectModel(UiElementNode uiNodeModel);
/**
* Returns the selection synchronizer object.
* The synchronizer can be used to sync the selection of 2 or more EditPartViewers.
*/
abstract public SelectionSynchronizer getSelectionSynchronizer();
abstract void reloadPalette();
abstract void recomputeLayout();
abstract UiDocumentNode getModel();
abstract LayoutEditor getLayoutEditor();
abstract Clipboard getClipboard();
}