Expand Minimize Picture-in-picture Power Device Status Voice Recognition Skip Back Skip Forward Minus Plus Play Search
Documentation
Sidebar

Customizing the Keyboard

If you present keyboards in your app – such as in searchable interactions or another custom keyboard – you may wish to customize the keyboard for your users. The best way to do this is through the SDLScreenManager. For more information presenting keyboards, see the Popup Menus and Keyboards guide.

Setting Keyboard Properties

You can modify the language of the keyboard to change the characters that are displayed.

Objective-C
SDLKeyboardProperties *keyboardConfig = [[SDLKeyboardProperties alloc] init];
keyboardConfig.language = SDLLanguageHeIl; // Set to Israeli Hebrew
keyboardConfig.keyboardLayout = SDLKeyboardLayoutAZERTY; // Set to AZERTY

self.sdlManager.screenManager.keyboardConfiguration = keyboardConfig;
Swift
let keyboardConfig = SDLKeyboardProperties()
keyboardConfig.language = .heIl // Set to Israeli Hebrew
keyboardConfig.keyboardLayout = .AZERTY; // Set to AZERTY

sdlManager.screenManager.keyboardConfiguration = keyboardConfig

Other Properties

While there are other keyboard properties available on SDLKeyboardProperties, these will be overridden by the screen manager. The keypressMode must be a specific configuration for the screen manager's callbacks to work properly. The limitedCharacterList, autoCompleteText, and autoCompleteList will be set on a per-keyboard basis in the SDLKeyboardDelegate which is set on the presentKeyboard and presentSearchableChoiceSet methods.

View on GitHub.com
Previous Section Next Section