All Downloads are FREE. Search and download functionalities are using the official Maven repository.

com.sun.javafx.scene.KeyboardShortcutsHandler Maven / Gradle / Ivy

There is a newer version: 24-ea+5
Show newest version
/*
 * Copyright (c) 2011, 2016, 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 com.sun.javafx.scene;

import java.util.AbstractMap;
import java.util.AbstractSet;
import java.util.ArrayList;
import java.util.ConcurrentModificationException;
import java.util.HashMap;
import java.util.Iterator;
import java.util.Map;
import java.util.Set;

import javafx.collections.ObservableList;
import javafx.collections.ObservableMap;
import javafx.event.Event;
import javafx.scene.Node;
import javafx.scene.input.KeyCode;
import javafx.scene.input.KeyCombination;
import javafx.scene.input.KeyEvent;
import javafx.scene.input.Mnemonic;

import com.sun.javafx.PlatformUtil;
import com.sun.javafx.collections.ObservableListWrapper;
import com.sun.javafx.collections.ObservableMapWrapper;
import com.sun.javafx.event.BasicEventDispatcher;
import com.sun.javafx.scene.traversal.Direction;

public final class KeyboardShortcutsHandler extends BasicEventDispatcher {
    private ObservableMap accelerators;
    private CopyOnWriteMap acceleratorsBackingMap;
    private ObservableMap> mnemonics;

    public void addMnemonic(Mnemonic m) {
        ObservableList mnemonicsList = getMnemonics().get(m.getKeyCombination());
        if (mnemonicsList == null) {
            mnemonicsList = new ObservableListWrapper<>(new ArrayList<>());
            getMnemonics().put(m.getKeyCombination(), mnemonicsList);
        }
        boolean foundMnemonic = false;
        for (Mnemonic mnemonic : mnemonicsList) {
            if (mnemonic == m) {
                foundMnemonic = true;
                break;
            }
        }
        if (!foundMnemonic) {
            mnemonicsList.add(m);
        }
    }

    public void removeMnemonic(Mnemonic m) {
        ObservableList mnemonicsList = getMnemonics().get(m.getKeyCombination());
        if (mnemonicsList != null) {
            for (int i = 0 ; i < mnemonicsList.size() ; i++) {
                if (mnemonicsList.get(i).getNode() == m.getNode()) {
                    mnemonicsList.remove(i);
                }
            }
        }
    }

    public ObservableMap> getMnemonics() {
        if (mnemonics == null) {
            mnemonics = new ObservableMapWrapper<>(new HashMap<>());
        }
        return mnemonics;
    }

    public ObservableMap getAccelerators() {
        if (accelerators == null) {
            acceleratorsBackingMap = new CopyOnWriteMap<>();
            accelerators = new ObservableMapWrapper<>(acceleratorsBackingMap);
        }
        return accelerators;
    }

    private void traverse(Event event, Node node, Direction dir) {
        if (NodeHelper.traverse(node, dir)) {
            event.consume();
        }
    }

    public void processTraversal(Event event) {
        if (event.getEventType() != KeyEvent.KEY_PRESSED) return;
        if (!(event instanceof KeyEvent)) return;

        KeyEvent keyEvent = (KeyEvent)event;
        if (!keyEvent.isMetaDown() && !keyEvent.isControlDown() && !keyEvent.isAltDown()) {
            Object obj = event.getTarget();
            if (!(obj instanceof Node)) return;

            Node node = (Node)obj;
            switch (keyEvent.getCode()) {
              case TAB :
                  if (keyEvent.isShiftDown()) {
                      traverse(event, node, Direction.PREVIOUS);
                  }
                  else {
                      traverse(event, node, Direction.NEXT);
                  }
                  break;
              case UP :
                  traverse(event, node, Direction.UP);
                  break;
              case DOWN :
                  traverse(event, node, Direction.DOWN);
                  break;
              case LEFT :
                  traverse(event, node, Direction.LEFT);
                  break;
              case RIGHT :
                  traverse(event, node, Direction.RIGHT);
                  break;
              default :
                  break;
            }
        }
    }

    @Override
    public Event dispatchBubblingEvent(Event event) {
        /*
         * Historically, we processed all unconsumed events in the following order:
         *    . Mnemonics,
         *    . Accelerators,
         *    . Navigation.
         * But we have now split the handling between capturing and bubbling phases.
         * In the capturing phase we handle mnemonics, and in the bubbling
         * phase we handle accelerators and navigation. See dispatchCapturingEvent for
         * the other half of this impl.
         */
        if (!(event instanceof KeyEvent)) return event;
        final boolean keyPressedEvent = event.getEventType() == KeyEvent.KEY_PRESSED;
        final KeyEvent keyEvent = (KeyEvent)event;

        if (keyPressedEvent) {
            if (!event.isConsumed()) {
                processAccelerators(keyEvent);
            }

            if (!event.isConsumed()) {
                processTraversal(event);
            }
        }

        return event;
    }

    @Override
    public Event dispatchCapturingEvent(Event event) {
        /*
         * Historically, we processed all unconsumed events in the following order:
         *    . Mnemonics,
         *    . Accelerators,
         *    . Navigation.
         * But we have now split the handling between capturing and bubbling phases.
         * In the capturing phase we handle mnemonics, and in the bubbling
         * phase we handle accelerators and navigation. See dispatchBubblingEvent for
         * the other half of this impl.
         */
        if (!(event instanceof KeyEvent)) return event;
        final boolean keyPressedEvent = event.getEventType() == KeyEvent.KEY_PRESSED;
        final boolean keyTypedEvent = event.getEventType() == KeyEvent.KEY_TYPED;
        final boolean keyReleasedEvent = event.getEventType() == KeyEvent.KEY_RELEASED;
        final KeyEvent keyEvent = (KeyEvent)event;

        if (keyPressedEvent || keyTypedEvent) {
            if (PlatformUtil.isMac()) {
                if (keyEvent.isMetaDown()) {
                    processMnemonics(keyEvent);
                }
            } else if (keyEvent.isAltDown() || isMnemonicsDisplayEnabled()) {
                processMnemonics(keyEvent);
            }
        }

        /*
        ** if we're not on mac, and nobody consumed the event, then we should
        ** check to see if we should highlight the mnemonics on the scene
        */
        if (!PlatformUtil.isMac() && !event.isConsumed()) {
            if (keyPressedEvent) {
                if (keyEvent.isAltDown()) {
                    // show mnemonic underline when alt is pressed
                    if (!isMnemonicsDisplayEnabled()) {
                        setMnemonicsDisplayEnabled(true);
                    } else {
                        if (PlatformUtil.isWindows()) {
                            setMnemonicsDisplayEnabled(!isMnemonicsDisplayEnabled());
                        }
                    }
                } else if (keyEvent.getCode() == KeyCode.ESCAPE) {
                    // when escape is pressed we remove the mnemonic underline again
                    setMnemonicsDisplayEnabled(false);
                }
            }
            if (keyReleasedEvent && !keyEvent.isAltDown() && !PlatformUtil.isWindows()) {
                setMnemonicsDisplayEnabled(false);
            }
        }
        return event;
    }

    private void processMnemonics(final KeyEvent event) {
        if (mnemonics == null) return;

         // we are going to create a lookup event that is a copy of this event
        // except replacing KEY_TYPED with KEY_PRESSED. If we find a mnemonic
        // with this lookup event, we will consume the event so that
        // KEY_TYPED events are not fired after a mnemonic consumed the
        // KEY_PRESSED event.
        // We pass in isMnemonicDisplayEnabled() for the altDown test, as if
        // mnemonic display has been enabled, we can act as if the alt key is
        // being held down.
        KeyEvent lookupEvent = event;
        if (event.getEventType() == KeyEvent.KEY_TYPED) {
            lookupEvent = new KeyEvent(null, event.getTarget(), KeyEvent.KEY_PRESSED,
                    " ",
                    event.getCharacter(),
                    KeyCode.getKeyCode(event.getCharacter()),
                    event.isShiftDown(),
                    event.isControlDown(),
                    isMnemonicsDisplayEnabled(),
                    event.isMetaDown());
        } else if (isMnemonicsDisplayEnabled()) {
            lookupEvent = new KeyEvent(null, event.getTarget(), KeyEvent.KEY_PRESSED,
                    event.getCharacter(),
                    event.getText(),
                    event.getCode(),
                    event.isShiftDown(),
                    event.isControlDown(),
                    isMnemonicsDisplayEnabled(),
                    event.isMetaDown());
        }


        ObservableList mnemonicsList = null;

        for (Map.Entry> mnemonic: mnemonics.entrySet()) {
            if (mnemonic.getKey().match(lookupEvent)) {
                mnemonicsList = mnemonic.getValue();
                break;
            }
        }

        if (mnemonicsList == null) return;

        /*
        ** for mnemonics we need to check if visible and reachable....
        ** if a single Mnemonic on the keyCombo we
        ** fire the runnable in Mnemoninic, and transfer focus
        ** if there is more than one then we just
        ** transfer the focus
        **
        */
        boolean multipleNodes = false;
        Node firstNode = null;
        Mnemonic firstMnemonics = null;
        int focusedIndex = -1;
        int nextFocusable = -1;

        /*
        ** find first focusable node
        */
        for (int i = 0 ; i < mnemonicsList.size() ; i++) {
            Mnemonic mnemonic = mnemonicsList.get(i);
            Node currentNode = mnemonic.getNode();

            if (firstMnemonics == null && (NodeHelper.isTreeVisible(currentNode) && !currentNode.isDisabled())) {
                firstMnemonics = mnemonic;
            }

            if (NodeHelper.isTreeVisible(currentNode) && (currentNode.isFocusTraversable() && !currentNode.isDisabled())) {
                if (firstNode == null) {
                    firstNode = currentNode;
                } else {
                    /*
                    ** there is more than one node on this keyCombo
                    */
                    multipleNodes = true;
                    if (focusedIndex != -1) {
                        if (nextFocusable == -1) {
                            nextFocusable = i;
                        }
                    }
                }
            }

            /*
            ** one of our targets has the focus already
            */
            if (currentNode.isFocused()) {
                focusedIndex = i;
            }
        }

        if (firstNode != null) {
            if (!multipleNodes == true) {
                /*
                ** just one target
                */
                firstNode.requestFocus();
                event.consume();
            }
            else {
                /*
                ** we have multiple nodes using the same mnemonic.
                ** this is allowed for nmemonics, and we simple
                ** focus traverse between them
                */
                if (focusedIndex == -1) {
                    firstNode.requestFocus();
                    event.consume();
                }
                else {
                    if (focusedIndex >= mnemonicsList.size()) {
                        firstNode.requestFocus();
                        event.consume();
                    }
                    else {
                        if (nextFocusable != -1) {
                            mnemonicsList.get(nextFocusable).getNode().requestFocus();
                        }
                        else {
                            firstNode.requestFocus();
                        }
                        event.consume();
                    }
                }
            }
        }

        if (!multipleNodes && firstMnemonics != null) {
            if (event.getEventType() == KeyEvent.KEY_TYPED) {
                event.consume();
            } else {
                firstMnemonics.fire();
                event.consume();
            }
        }
    }

    private void processAccelerators(KeyEvent event) {
        if (acceleratorsBackingMap != null) {
            acceleratorsBackingMap.lock();
            try {
                for (Map.Entry
                        accelerator : acceleratorsBackingMap.backingMap.entrySet()) {

                    if (accelerator.getKey().match(event)) {
                        Runnable acceleratorRunnable = accelerator.getValue();
                        if (acceleratorRunnable != null) {
                        /*
                        ** for accelerators there can only be one target
                        ** and we don't care whether it's visible or reachable....
                        ** we just run the Runnable.......
                        */
                            acceleratorRunnable.run();
                            event.consume();
                        }
                    }
                }
            } finally {
                acceleratorsBackingMap.unlock();
            }
        }
    }

    private void processMnemonicsKeyDisplay() {
        ObservableList mnemonicsList = null;
        if (mnemonics != null) {
            for (Map.Entry> mnemonic: mnemonics.entrySet()) {
                mnemonicsList = (ObservableList) mnemonic.getValue();

                if (mnemonicsList != null) {
                    for (int i = 0 ; i < mnemonicsList.size() ; i++) {
                        Node currentNode = (Node)mnemonicsList.get(i).getNode();
                        NodeHelper.setShowMnemonics(currentNode, mnemonicsDisplayEnabled);
                    }
                }
            }
        }
    }

    /*
    ** remember if the alt key is being held
    */
    private boolean mnemonicsDisplayEnabled = false;

    public boolean isMnemonicsDisplayEnabled() {
        return mnemonicsDisplayEnabled;
    }
    public void setMnemonicsDisplayEnabled(boolean b) {
        if (b != mnemonicsDisplayEnabled) {
            mnemonicsDisplayEnabled = b;
            processMnemonicsKeyDisplay();
        }
    }

    public void clearNodeMnemonics(Node node) {
        if (mnemonics != null) {
            for (ObservableList list : mnemonics.values()) {
                for (Iterator it = list.iterator(); it.hasNext(); ) {
                    Mnemonic m = it.next();
                    if (m.getNode() == node) {
                        it.remove();
                    }
                }
            }
        }
    }

    private static class CopyOnWriteMap extends AbstractMap {

        private Map backingMap = new HashMap<>();
        private boolean lock;

        public void lock() {
            lock = true;
        }

        public void unlock() {
            lock = false;
        }

        @Override
        public V put(K key, V value) {
            if (lock) {
                backingMap = new HashMap<>(backingMap);
                lock = false;
            }
            return backingMap.put(key, value);
        }

        @Override
        public Set> entrySet() {
            return new AbstractSet>() {
                @Override
                public Iterator> iterator() {
                    return new Iterator>() {

                        private Iterator> backingIt = backingMap.entrySet().iterator();
                        private Map backingMapAtCreation = backingMap;
                        private Entry lastNext = null;

                        @Override
                        public boolean hasNext() {
                            checkCoMod();
                            return backingIt.hasNext();
                        }

                        private void checkCoMod() {
                            if (backingMap != backingMapAtCreation) {
                                throw new ConcurrentModificationException();
                            }
                        }

                        @Override
                        public Entry next() {
                            checkCoMod();
                            return lastNext = backingIt.next();
                        }

                        @Override
                        public void remove() {
                            checkCoMod();
                            if (lastNext == null) {
                                throw new IllegalStateException();
                            }
                            if (lock) {
                                backingMap = new HashMap<>(backingMap);
                                backingIt = backingMap.entrySet().iterator();
                                while (!lastNext.equals(backingIt.next()));
                                lock = false;
                            }
                            backingIt.remove();
                            lastNext = null;
                        }
                    };
                }

                @Override
                public int size() {
                    return backingMap.size();
                }
            };
        }
    }
}




© 2015 - 2024 Weber Informatics LLC | Privacy Policy