115f93eeeb
Currently keyboard maps allow to assign character sequences to key events and allow specifying a so-called "fallback" key events that are re-injected into input stream if target application indicates that it was not able to handle the original key event. Unfortunately there is no way to perform substitution before handing the event to applicationis. This change adds a new keymap keyword "replace" that allows users query "replacement" actions for key (if any), with the intent that such replacement happens early in the event handling process. Bug: 24504154 Change-Id: I3e6a2476c856524171df00ad22ff56f2018c1278
105 lines
3.0 KiB
C++
105 lines
3.0 KiB
C++
/*
|
|
* Copyright (C) 2010 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.
|
|
*/
|
|
|
|
#ifndef _LIBINPUT_KEYBOARD_H
|
|
#define _LIBINPUT_KEYBOARD_H
|
|
|
|
#include <input/Input.h>
|
|
#include <input/InputDevice.h>
|
|
#include <input/InputEventLabels.h>
|
|
#include <utils/Errors.h>
|
|
#include <utils/String8.h>
|
|
#include <utils/PropertyMap.h>
|
|
|
|
namespace android {
|
|
|
|
enum {
|
|
/* Device id of the built in keyboard. */
|
|
DEVICE_ID_BUILT_IN_KEYBOARD = 0,
|
|
|
|
/* Device id of a generic virtual keyboard with a full layout that can be used
|
|
* to synthesize key events. */
|
|
DEVICE_ID_VIRTUAL_KEYBOARD = -1,
|
|
};
|
|
|
|
class KeyLayoutMap;
|
|
class KeyCharacterMap;
|
|
|
|
/**
|
|
* Loads the key layout map and key character map for a keyboard device.
|
|
*/
|
|
class KeyMap {
|
|
public:
|
|
String8 keyLayoutFile;
|
|
sp<KeyLayoutMap> keyLayoutMap;
|
|
|
|
String8 keyCharacterMapFile;
|
|
sp<KeyCharacterMap> keyCharacterMap;
|
|
|
|
KeyMap();
|
|
~KeyMap();
|
|
|
|
status_t load(const InputDeviceIdentifier& deviceIdenfier,
|
|
const PropertyMap* deviceConfiguration);
|
|
|
|
inline bool haveKeyLayout() const {
|
|
return !keyLayoutFile.isEmpty();
|
|
}
|
|
|
|
inline bool haveKeyCharacterMap() const {
|
|
return !keyCharacterMapFile.isEmpty();
|
|
}
|
|
|
|
inline bool isComplete() const {
|
|
return haveKeyLayout() && haveKeyCharacterMap();
|
|
}
|
|
|
|
private:
|
|
bool probeKeyMap(const InputDeviceIdentifier& deviceIdentifier, const String8& name);
|
|
status_t loadKeyLayout(const InputDeviceIdentifier& deviceIdentifier, const String8& name);
|
|
status_t loadKeyCharacterMap(const InputDeviceIdentifier& deviceIdentifier,
|
|
const String8& name);
|
|
String8 getPath(const InputDeviceIdentifier& deviceIdentifier,
|
|
const String8& name, InputDeviceConfigurationFileType type);
|
|
};
|
|
|
|
/**
|
|
* Returns true if the keyboard is eligible for use as a built-in keyboard.
|
|
*/
|
|
extern bool isEligibleBuiltInKeyboard(const InputDeviceIdentifier& deviceIdentifier,
|
|
const PropertyMap* deviceConfiguration, const KeyMap* keyMap);
|
|
|
|
/**
|
|
* Updates a meta state field when a key is pressed or released.
|
|
*/
|
|
extern int32_t updateMetaState(int32_t keyCode, bool down, int32_t oldMetaState);
|
|
|
|
/**
|
|
* Normalizes the meta state such that if either the left or right modifier
|
|
* meta state bits are set then the result will also include the universal
|
|
* bit for that modifier.
|
|
*/
|
|
extern int32_t normalizeMetaState(int32_t oldMetaState);
|
|
|
|
/**
|
|
* Returns true if a key is a meta key like ALT or CAPS_LOCK.
|
|
*/
|
|
extern bool isMetaKey(int32_t keyCode);
|
|
|
|
} // namespace android
|
|
|
|
#endif // _LIBINPUT_KEYBOARD_H
|