Keyboard Support

Contact and Search

Keyman.com Homepage

Header bottom

Keyman.com

Other versions
Version 18.0Version 17.0 (current version)Version 16.0Version 15.0Version 14.0Version 13.0Version 12.0Version 11.0Version 10.0Version 2.0

Index

On this page

KMManager.setGlobeKeyAction()


Summary

The setGlobeKeyAction() method sets the short-press action type for the 'Globe' key.

Syntax

KMManager.setGlobeKeyAction(KeyboardType kbType, int action)

Parameters

type

KeyboardType.KEYBOARD_TYPE_INAPP or KeyboardType.KEYBOARD_TYPE_SYSTEM

action

The action type. GLOBE_KEY_ACTION_SHOW_MENU, GLOBE_KEY_ACTION_SWITCH_TO_NEXT_KEYBOARD, GLOBE_KEY_ACTION_ADVANCE_TO_PREVIOUS_SYSTEM_KEYBOARD, GLOBE_KEY_ACTION_ADVANCE_TO_NEXT_SYSTEM_KEYBOARD, GLOBE_KEY_ACTION_SHOW_SYSTEM_KEYBOARDS, GLOBE_KEY_ACTION_DO_NOTHING.

Description

Use this method to set the short-press action type for the 'Globe' key. Even when the default action type is set, Keyman Engine will still use the following default action types when only one Keyman keyboard is installed:

KeyboardType # Keyman Keyboards Installed Globe Key Action Type
KEYBOARD_TYPE_INAPP 1 GLOBE_KEY_ACTION_SHOW_MENU
KEYBOARD_TYPE_SYSTEM 1 GLOBE_KEY_ACTION_ADVANCE_TO_PREVIOUS_SYSTEM_KEYBOARD

The action GLOBE_KEY_ACTION_SHOW_MENU displays the Keyman keyboard picker menu. Other enabled system keyboards are also listed at the end of the menu

The action GLOBE_KEY_ACTION_SWITCH_TO_NEXT_KEYBOARD switches to the next Keyman keyboard (if more than 1 are installed). Otherwise, the Keyman keyboard picker menu is displayed.

The action GLOBE_KEY_ACTION_ADVANCE_TO_PREVIOUS_SYSTEM_KEYBOARD switches to the previous system keyboard.

The action GLOBE_KEY_ACTION_ADVANCE_TO_NEXT_SYSTEM_KEYBOARD switches to the next system keyboard.

The action GLOBE_KEY_ACTION_SHOW_SYSTEM_KEYBOARDS brings up the Android input method picker and can only be set for KEYBOARD_TYPE_SYSTEM.

Examples

Example: Using setGlobeKeyAction

The following script illustrate the use of setGlobeKeyAction

// Tapping 'Globe' key will switch to the next keyboard
KMManager.setGlobeKeyAction(KeyboardType.KEYBOARD_TYPE_SYSTEM, 
    GlobeKeyAction.GLOBE_KEY_ACTION_SWITCH_TO_NEXT_KEYBOARD);

See also