plugins/org.eclipse.actf.ai.navigator/src/org/eclipse/actf/ai/navigator/IManipulator.java

/*******************************************************************************
 * Copyright (c) 2007 IBM Corporation 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:
 *    Hisashi MIYASHITA - initial API and implementation
 *******************************************************************************/

package org.eclipse.actf.ai.navigator;


/**
 * IManipulator interface defines the methods to be implemented by the "manipulator"
 * of the application. For example keyboard manipulator, joy stick manipulator, and so on.
 * IManipulator can obtain instances of IBrowserControl and INavigatorUI.
 */
public interface IManipulator {
    /**
     * This Mode class represents modes of the application.
     */
    public static class Mode {
        public final String name;
        public final int code;
        private Mode(String name, int code) {
            this.name = name;
            this.code = code;
        }
    }
    
    /**
     * The code of the tree navigation mode.
     */
    int TREE_NAVIGATION_MODE_CODE = 0;
    
    /**
     * The instance of the Mode of the tree navigation mode.
     * This is the default mode of the application.
     */
    Mode TREE_NAVIGATION_MODE = new Mode(Messages.getString("IManipulator.TreeNavigaion"), TREE_NAVIGATION_MODE_CODE); //$NON-NLS-1$
    
    /**
     * The code of the form input mode.
     */
    int FORM_INPUT_MODE_CODE = 1;
    
    /**
     * The instance of the Mode of the form input mode.
     * This mode is used during the users input information into HTML forms.
     */
    Mode FORM_INPUT_MODE = new Mode(Messages.getString("IManipulator.FormInput"), FORM_INPUT_MODE_CODE); //$NON-NLS-1$
    
    /**
     * The code of the key hook disabled mode.
     */
    int KEYHOOK_DISABLED_MODE_CODE = 2;
    
    /**
     * The instance of the Mode of the key hook disabled mode.
     * This mode is used during a dialog is shown.
     */
    Mode KEYHOOK_DISABLED_MODE = new Mode(Messages.getString("IManipulator.Input"), KEYHOOK_DISABLED_MODE_CODE); //$NON-NLS-1$

    /**
     * @param browserControl The instance of the IBrowserControl to be controlled by the manipulator.
     */
    void setBrowserControl(IBrowserControl browserControl);
    /**
     * @param navigatorUI The instance of the INavigatorUI to be controlled by the manipulator.
     */
    void setNavigator(INavigatorUI navigatorUI);
    
    /**
     * @param mode The mode to be set
     */
    void setMode(Mode mode);
    
    /**
     *  It will be called when the manipulator is disposed.
     */
    void dispose();
}