/*

 * Copyright (c) 2008, 2018, Oracle and/or its affiliates. All rights reserved.

 * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.

 *

 * This code is free software; you can redistribute it and/or modify it

 * under the terms of the GNU General Public License version 2 only, as

 * published by the Free Software Foundation.  Oracle designates this

 * particular file as subject to the "Classpath" exception as provided

 * by Oracle in the LICENSE file that accompanied this code.

 *

 * This code is distributed in the hope that it will be useful, but WITHOUT

 * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or

 * FITNESS FOR A PARTICULAR PURPOSE.  See the GNU General Public License

 * version 2 for more details (a copy is included in the LICENSE file that

 * accompanied this code).

 *

 * You should have received a copy of the GNU General Public License version

 * 2 along with this work; if not, write to the Free Software Foundation,

 * Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA.

 *

 * Please contact Oracle, 500 Oracle Parkway, Redwood Shores, CA 94065 USA

 * or visit www.oracle.com if you need additional information or have any

 * questions.

 */

package sun.awt;

import jdk.internal.misc.Unsafe;

import javax.accessibility.AccessibleContext;

import java.awt.*;

import java.awt.event.FocusEvent.Cause;

import java.awt.dnd.DragSourceContext;

import java.awt.dnd.DropTargetContext;

import java.awt.dnd.peer.DragSourceContextPeer;

import java.awt.dnd.peer.DropTargetContextPeer;

import java.awt.event.AWTEventListener;

import java.awt.event.InputEvent;

import java.awt.event.InvocationEvent;

import java.awt.event.KeyEvent;

import java.awt.event.MouseEvent;

import java.awt.geom.Point2D;

import java.awt.image.BufferStrategy;

import java.awt.peer.ComponentPeer;

import java.awt.peer.MenuComponentPeer;

import java.lang.reflect.InvocationTargetException;

import java.security.AccessControlContext;

import java.io.File;

import java.util.ResourceBundle;

import java.util.Vector;

import javax.accessibility.AccessibleBundle;

/**

 * The AWTAccessor utility class.

 * The main purpose of this class is to enable accessing

 * private and package-private fields of classes from

 * different classes/packages. See sun.misc.SharedSecretes

 * for another example.

 */

public final class AWTAccessor {

    private static final Unsafe unsafe = Unsafe.getUnsafe();

    /*

     * We don't need any objects of this class.

     * It's rather a collection of static methods

     * and interfaces.

     */

    private AWTAccessor() {

    }

    /*

     * An interface of accessor for the java.awt.Component class.

     */

    public interface ComponentAccessor {

        /*

         * Sets whether the native background erase for a component

         * has been disabled via SunToolkit.disableBackgroundErase().

         */

        void setBackgroundEraseDisabled(Component comp, boolean disabled);

        /*

         * Indicates whether the native background erase for a

         * component has been disabled via

         * SunToolkit.disableBackgroundErase().

         */

        boolean getBackgroundEraseDisabled(Component comp);

        /*

         *

         * Gets the bounds of this component in the form of a

         * {@code Rectangle} object. The bounds specify this

         * component's width, height, and location relative to

         * its parent.

         */

        Rectangle getBounds(Component comp);

        /**

         * Sets GraphicsConfiguration value for the component.

         */

        void setGraphicsConfiguration(Component comp, GraphicsConfiguration gc);

        /*

         * Requests focus to the component.

         */

        void requestFocus(Component comp, Cause cause);

        /*

         * Determines if the component can gain focus.

         */

        boolean canBeFocusOwner(Component comp);

        /**

         * Returns whether the component is visible without invoking

         * any client code.

         */

        boolean isVisible(Component comp);

        /**

         * Sets the RequestFocusController.

         */

        void setRequestFocusController(RequestFocusController requestController);

        /**

         * Returns the appContext of the component.

         */

        AppContext getAppContext(Component comp);

        /**

         * Sets the appContext of the component.

         */

        void setAppContext(Component comp, AppContext appContext);

        /**

         * Returns the parent of the component.

         */

        Container getParent(Component comp);

        /**

         * Sets the parent of the component to the specified parent.

         */

        void setParent(Component comp, Container parent);

        /**

         * Resizes the component to the specified width and height.

         */

        void setSize(Component comp, int width, int height);

        /**

         * Returns the location of the component.

         */

        Point getLocation(Component comp);

        /**

         * Moves the component to the new location.

         */

        void setLocation(Component comp, int x, int y);

        /**

         * Determines whether this component is enabled.

         */

        boolean isEnabled(Component comp);

        /**

         * Determines whether this component is displayable.

         */

        boolean isDisplayable(Component comp);

        /**

         * Gets the cursor set in the component.

         */

        Cursor getCursor(Component comp);

        /**

         * Returns the peer of the component.

         */

        <T extends ComponentPeer> T getPeer(Component comp);

        /**

         * Sets the peer of the component to the specified peer.

         */

        void setPeer(Component comp, ComponentPeer peer);

        /**

         * Determines whether this component is lightweight.

         */

        boolean isLightweight(Component comp);

        /**

         * Returns whether or not paint messages received from

         * the operating system should be ignored.

         */

        boolean getIgnoreRepaint(Component comp);

        /**

         * Returns the width of the component.

         */

        int getWidth(Component comp);

        /**

         * Returns the height of the component.

         */

        int getHeight(Component comp);

        /**

         * Returns the x coordinate of the component.

         */

        int getX(Component comp);

        /**

         * Returns the y coordinate of the component.

         */

        int getY(Component comp);

        /**

         * Gets the foreground color of this component.

         */

        Color getForeground(Component comp);

        /**

         * Gets the background color of this component.

         */

        Color getBackground(Component comp);

        /**

         * Sets the background of this component to the specified color.

         */

        void setBackground(Component comp, Color background);

        /**

         * Gets the font of the component.

         */

        Font getFont(Component comp);

        /**

         * Processes events occurring on this component.

         */

        void processEvent(Component comp, AWTEvent e);

        /*

         * Returns the acc this component was constructed with.

         */

        AccessControlContext getAccessControlContext(Component comp);

        /**

         * Revalidates the component synchronously.

         */

        void revalidateSynchronously(Component comp);

        /**

         * Creates a new strategy for multi-buffering on this component.

         */

        void createBufferStrategy(Component comp, int numBuffers,

                BufferCapabilities caps) throws AWTException;

        /**

         * returns the buffer strategy used by this component.

         */

        BufferStrategy getBufferStrategy(Component comp);

    }

    /*

     * An interface of accessor for the java.awt.Container class.

     */

    public interface ContainerAccessor {

        /**

         * Validates the container unconditionally.

         */

        void validateUnconditionally(Container cont);

        /**

         *

         * Access to the private version of findComponentAt method which has

         * a controllable behavior. Setting 'ignoreEnabled' to 'false'

         * bypasses disabled Components during the search.

         */

        Component findComponentAt(Container cont, int x, int y, boolean ignoreEnabled);

        /**

         * Starts LW Modal.

         */

        void startLWModal(Container cont);

        /**

         * Starts LW Modal.

         */

        void stopLWModal(Container cont);

    }

    /*

     * An interface of accessor for java.awt.Window class.

     */

    public interface WindowAccessor {

        /*

         * Update the image of a non-opaque (translucent) window.

         */

        void updateWindow(Window window);

        /**

         * Set the size of the security warning.

         */

        void setSecurityWarningSize(Window w, int width, int height);

        /** Request to recalculate the new position of the security warning for

         * the given window size/location as reported by the native system.

         */

        Point2D calculateSecurityWarningPosition(Window window,

                double x, double y, double w, double h);

        /** Sets the synchronous status of focus requests on lightweight

         * components in the specified window to the specified value.

         */

        void setLWRequestStatus(Window changed, boolean status);

        /**

         * Indicates whether this window should receive focus on subsequently

         * being shown, or being moved to the front.

         */

        boolean isAutoRequestFocus(Window w);

        /**

         * Indicates whether the specified window is an utility window for TrayIcon.

         */

        boolean isTrayIconWindow(Window w);

        /**

         * Marks the specified window as an utility window for TrayIcon.

         */

        void setTrayIconWindow(Window w, boolean isTrayIconWindow);

        /**

         * Return an array containing all the windows this

         * window currently owns.

         */

        Window[] getOwnedWindows(Window w);

    }

    /**

     * An accessor for the AWTEvent class.

     */

    public interface AWTEventAccessor {

        /**

         * Marks the event as posted.

         */

        void setPosted(AWTEvent ev);

        /**

         * Sets the flag on this AWTEvent indicating that it was

         * generated by the system.

         */

        void setSystemGenerated(AWTEvent ev);

        /**

         * Indicates whether this AWTEvent was generated by the system.

         */

        boolean isSystemGenerated(AWTEvent ev);

        /**

         * Returns the acc this event was constructed with.

         */

        AccessControlContext getAccessControlContext(AWTEvent ev);

        /**

         * Returns binary data associated with this event;

         */

        byte[] getBData(AWTEvent ev);

        /**

         * Associates binary data with this event;

         */

        void setBData(AWTEvent ev, byte[] bdata);

    }

    public interface InputEventAccessor {

        /*

         * Accessor for InputEvent.getButtonDownMasks()

         */

        int[] getButtonDownMasks();

        /*

         * Accessor for InputEvent.canAccessSystemClipboard field

         */

        boolean canAccessSystemClipboard(InputEvent event);

        void setCanAccessSystemClipboard(InputEvent event,

                boolean canAccessSystemClipboard);

    }

    /**

     * An accessor for the MouseEvent class.

     */

    public interface MouseEventAccessor {

        /**

         * Indicates whether the event is a result of a touch event.

         */

        boolean isCausedByTouchEvent(MouseEvent ev);

        /**

         * Sets whether the event is a result of a touch event.

         */

        void setCausedByTouchEvent(MouseEvent ev, boolean causedByTouchEvent);

    }

    /*

     * An accessor for the java.awt.Frame class.

     */

    public interface FrameAccessor {

        /*

         * Sets the state of this frame.

         */

        void setExtendedState(Frame frame, int state);

        /*

         * Gets the state of this frame.

         */

       int getExtendedState(Frame frame);

        /*

         * Gets the maximized bounds of this frame.

         */

       Rectangle getMaximizedBounds(Frame frame);

    }

    /**

     * An interface of accessor for the java.awt.KeyboardFocusManager class.

     */

    public interface KeyboardFocusManagerAccessor {

        /**

         * Indicates whether the native implementation should

         * proceed with a pending focus request for the heavyweight.

         */

        int shouldNativelyFocusHeavyweight(Component heavyweight,

                                           Component descendant,

                                           boolean temporary,

                                           boolean focusedWindowChangeAllowed,

                                           long time,

                                           Cause cause);

        /**

         * Delivers focus for the lightweight descendant of the heavyweight

         * synchronously.

         */

        boolean processSynchronousLightweightTransfer(Component heavyweight,

                                                      Component descendant,

                                                      boolean temporary,

                                                      boolean focusedWindowChangeAllowed,

                                                      long time);

        /**

         * Removes the last focus request for the heavyweight from the queue.

         */

        void removeLastFocusRequest(Component heavyweight);

        /**

         * Gets the most recent focus owner in the window.

         */

        Component getMostRecentFocusOwner(Window window);

        /**

         * Sets the most recent focus owner in the window.

         */

        void setMostRecentFocusOwner(Window window, Component component);

        /**

         * Returns current KFM of the specified AppContext.

         */

        KeyboardFocusManager getCurrentKeyboardFocusManager(AppContext ctx);

        /**

         * Return the current focus cycle root

         */

        Container getCurrentFocusCycleRoot();

    }

    /**

     * An accessor for the MenuComponent class.

     */

    public interface MenuComponentAccessor {

        /**

         * Returns the appContext of the menu component.

         */

        AppContext getAppContext(MenuComponent menuComp);

        /**

         * Sets the appContext of the menu component.

         */

        void setAppContext(MenuComponent menuComp, AppContext appContext);

        /**

         * Returns the peer of the menu component.

         */

        <T extends MenuComponentPeer> T getPeer(MenuComponent menuComp);

        /**

         * Returns the menu container of the menu component.

         */

        MenuContainer getParent(MenuComponent menuComp);