diff options
Diffstat (limited to 'src/android/support/v4/view/KeyEventCompat.java')
-rw-r--r-- | src/android/support/v4/view/KeyEventCompat.java | 215 |
1 files changed, 215 insertions, 0 deletions
diff --git a/src/android/support/v4/view/KeyEventCompat.java b/src/android/support/v4/view/KeyEventCompat.java new file mode 100644 index 0000000..7dd5428 --- /dev/null +++ b/src/android/support/v4/view/KeyEventCompat.java @@ -0,0 +1,215 @@ +/* + * Copyright (C) 2011 The Android Open Source Project + * + * Licensed under the Apache License, Version 2.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.apache.org/licenses/LICENSE-2.0 + * + * 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 android.support.v4.view; + +import android.view.KeyEvent; +import android.view.View; + +/** + * Helper for accessing features in {@link KeyEvent} introduced after + * API level 4 in a backwards compatible fashion. + */ +public class KeyEventCompat { + /** + * Interface for the full API. + */ + interface KeyEventVersionImpl { + public int normalizeMetaState(int metaState); + public boolean metaStateHasModifiers(int metaState, int modifiers); + public boolean metaStateHasNoModifiers(int metaState); + public void startTracking(KeyEvent event); + public boolean isTracking(KeyEvent event); + public Object getKeyDispatcherState(View view); + public boolean dispatch(KeyEvent event, KeyEvent.Callback receiver, Object state, + Object target); + } + + /** + * Interface implementation that doesn't use anything about v4 APIs. + */ + static class BaseKeyEventVersionImpl implements KeyEventVersionImpl { + private static final int META_MODIFIER_MASK = + KeyEvent.META_SHIFT_ON | KeyEvent.META_SHIFT_LEFT_ON | KeyEvent.META_SHIFT_RIGHT_ON + | KeyEvent.META_ALT_ON | KeyEvent.META_ALT_LEFT_ON | KeyEvent.META_ALT_RIGHT_ON + | KeyEvent.META_SYM_ON; + + // Mask of all lock key meta states. + private static final int META_ALL_MASK = META_MODIFIER_MASK; + + private static int metaStateFilterDirectionalModifiers(int metaState, + int modifiers, int basic, int left, int right) { + final boolean wantBasic = (modifiers & basic) != 0; + final int directional = left | right; + final boolean wantLeftOrRight = (modifiers & directional) != 0; + + if (wantBasic) { + if (wantLeftOrRight) { + throw new IllegalArgumentException("bad arguments"); + } + return metaState & ~directional; + } else if (wantLeftOrRight) { + return metaState & ~basic; + } else { + return metaState; + } + } + + @Override + public int normalizeMetaState(int metaState) { + int ms = metaState; + if ((ms & (KeyEvent.META_SHIFT_LEFT_ON | KeyEvent.META_SHIFT_RIGHT_ON)) != 0) { + ms |= KeyEvent.META_SHIFT_ON; + } + if ((ms & (KeyEvent.META_ALT_LEFT_ON | KeyEvent.META_ALT_RIGHT_ON)) != 0) { + ms |= KeyEvent.META_ALT_ON; + } + return ms & META_ALL_MASK; + } + + @Override + public boolean metaStateHasModifiers(int metaState, int modifiers) { + int ms = metaState; + ms = normalizeMetaState(ms) & META_MODIFIER_MASK; + ms = metaStateFilterDirectionalModifiers(ms, modifiers, + KeyEvent.META_SHIFT_ON, KeyEvent.META_SHIFT_LEFT_ON, KeyEvent.META_SHIFT_RIGHT_ON); + ms = metaStateFilterDirectionalModifiers(ms, modifiers, + KeyEvent.META_ALT_ON, KeyEvent.META_ALT_LEFT_ON, KeyEvent.META_ALT_RIGHT_ON); + return ms == modifiers; + } + + @Override + public boolean metaStateHasNoModifiers(int metaState) { + return (normalizeMetaState(metaState) & META_MODIFIER_MASK) == 0; + } + + @Override + public void startTracking(KeyEvent event) { + return; + } + + @Override + public boolean isTracking(KeyEvent event) { + return false; + } + + @Override + public Object getKeyDispatcherState(View view) { + return null; + } + + @Override + @SuppressWarnings("deprecation") + public boolean dispatch(KeyEvent event, KeyEvent.Callback receiver, Object state, + Object target) { + return event.dispatch(receiver); + } + } + + static class EclairKeyEventVersionImpl extends BaseKeyEventVersionImpl { + @Override + public void startTracking(KeyEvent event) { + KeyEventCompatEclair.startTracking(event); + } + + @Override + public boolean isTracking(KeyEvent event) { + return KeyEventCompatEclair.isTracking(event); + } + + @Override + public Object getKeyDispatcherState(View view) { + return KeyEventCompatEclair.getKeyDispatcherState(view); + } + + @Override + public boolean dispatch(KeyEvent event, KeyEvent.Callback receiver, Object state, + Object target) { + return KeyEventCompatEclair.dispatch(event, receiver, state, target); + } + } + + /** + * Interface implementation for devices with at least v11 APIs. + */ + static class HoneycombKeyEventVersionImpl extends EclairKeyEventVersionImpl { + @Override + public int normalizeMetaState(int metaState) { + return KeyEventCompatHoneycomb.normalizeMetaState(metaState); + } + + @Override + public boolean metaStateHasModifiers(int metaState, int modifiers) { + return KeyEventCompatHoneycomb.metaStateHasModifiers(metaState, modifiers); + } + + @Override + public boolean metaStateHasNoModifiers(int metaState) { + return KeyEventCompatHoneycomb.metaStateHasNoModifiers(metaState); + } + } + + /** + * Select the correct implementation to use for the current platform. + */ + static final KeyEventVersionImpl IMPL; + static { + if (android.os.Build.VERSION.SDK_INT >= 11) { + IMPL = new HoneycombKeyEventVersionImpl(); + } else { + IMPL = new BaseKeyEventVersionImpl(); + } + } + + // ------------------------------------------------------------------- + + public static int normalizeMetaState(int metaState) { + return IMPL.normalizeMetaState(metaState); + } + + public static boolean metaStateHasModifiers(int metaState, int modifiers) { + return IMPL.metaStateHasModifiers(metaState, modifiers); + } + + public static boolean metaStateHasNoModifiers(int metaState) { + return IMPL.metaStateHasNoModifiers(metaState); + } + + public static boolean hasModifiers(KeyEvent event, int modifiers) { + return IMPL.metaStateHasModifiers(event.getMetaState(), modifiers); + } + + public static boolean hasNoModifiers(KeyEvent event) { + return IMPL.metaStateHasNoModifiers(event.getMetaState()); + } + + public static void startTracking(KeyEvent event) { + IMPL.startTracking(event); + } + + public static boolean isTracking(KeyEvent event) { + return IMPL.isTracking(event); + } + + public static Object getKeyDispatcherState(View view) { + return IMPL.getKeyDispatcherState(view); + } + + public static boolean dispatch(KeyEvent event, KeyEvent.Callback receiver, Object state, + Object target) { + return IMPL.dispatch(event, receiver, state, target); + } +} |