Table of Contents
Extends: Group
Description
The MiniKeyboard node class allows a user to enter a string of letters and numerals. The string entered is displayed in a TextEditBox node that is part of the MiniKeyboard node.
The MiniKeyboard node is intended for users to enter a simple case-insensitive string consisting of the letters A-Z and the numerals 0-9. It is intended for use in functions such as "Search", where the entered string need not support general case-sensitive text entry. For general text entry, use a Keyboard node instead.
The MiniKeyboard node must have the key focus in order to work properly.
The default appearance of the MiniKeyboard node is very transparent, allowing the keyboard to pick up most of its color from what is rendered underneath it. The appearance can be customized by changing the keyboardBitmapUri and other fields.
Fields
| Field | Type | Default | Use |
|---|---|---|---|
| text | string | "" | Contains the string of characters that has been entered |
| keyColor | color | 0xffffffff | Specifies the color of the key labels and icons when the Keyboard node does not have the focus |
| focusedKeyColor | color | 0xffffffff | Specifies the color of the key labels and icons when the Keyboard node has the focus |
| keyboardBitmapUri | string | "" | Specifies the URI of an image file to replace the default keyboard image drawn underneath the key label and icons. Note that this image must be carefully designed so that the key positions match the default image. Template images for SD, HD and FHD resolutions are provided below. |
| focusBitmapUri | string | "" | Specifies the URI of an image file to replace the default keyboard focus indicator. This should be a 9-patch image so that it can be stretched to the appropriate size for the double width keys. |
| textEditBox | TextEditBox node | system default | Read-Only |
| showTextEditBox | boolean | true | Specifies whether or not the internal TextEditBox node is displayed. In most cases, it is desirable to display the TextEditBox node so that the user can see the string as it is entered. In some cases though, you might want to only show the Keyboard node. In those cases, the |
| lowerCase | boolean | true | Specifies whether the 26 letter keys are displayed as lowercase or uppercase. |
Keyboard Bitmap Templates
- Use the links below to download the template files.
- The files have opaque white lines that show the key outlines with the rest of the images fully transparent. Looking at the files in some image viewers that do not support transparency will result in the images looking all white.
- When creating your own keyboard background artwork, you must maintain the size of the image and the position of the keys in order for it to align properly with the rendered key labels and icons.
SD MiniKeyboard Template
HD MiniKeyboard Template
FHD MiniKeyboard Template
Attachments:
SDMiniKeyboardTemplate.png (application/octet-stream)
HDMiniKeyboardTemplate.png (application/octet-stream)
FHDMiniKeyboardTemplate.png (application/octet-stream)