5. Text Input
5.1. Samsung IME
When text input is required, an on-screen keyboard must be provided. You can either create an on-screen keyboard specifically for the application, or use the Samsung IME provided by the Samsung app development tool (SDK).
Figure 5-1 shows the basic layout of the Samsung IME.
Figure 5-1. IME screen layout (default)
Figure 5-2. Input window when entering multiple lines
Input Guide Message
Provides guide text such as what information to enter, precautions to take when entering, and additional feedback about the input.
e.g. Enter your name.
Enter your name. (Cannot contain special characters)
Re-enter your name. (The user name entered does not exist.)
Input Guide Message
Displays necessary messages such as "Enter ID.", "Enter ID. (The ID you entered does not exist.)"
Displays the number of syllables entered and the maximum number of syllables that can be entered.
Displays the text that the user has entered. Provides one line of input by default. When necessary, multiple lines can be provided, as shown in Figure 5-2.
Recommended words are provided based on the characters entered by the user. Recommended words are provided by the system by default. Individual applications can, however, provide their own recommended words.
The user may select buttons to enter the corresponding characters.
5.2. IME Controls by Input Methods
The Samsung IME supports a range of input methods, including Samsung Smart Control, standard remote, mouse, keyboard, and voice control. Depending on the input device, you may enter text in the following ways.
Four-directional focus moving method (Samsung Smart Control and standard remotes)
Use the Up/down/left/right buttons to move to the character that you wish to enter. Select the corresponding character to enter it.
Figure 5-3. Four-directional focus moving method
Pointing Method (Samsung Smart Control, Motion Control, and mouse)
Move the pointer to the character that you wish to enter. Select the corresponding character to enter it.
Figure 5-4. Pointer Method
Input method using keyboards
When there is input from a physical keyboard while the Samsung IME is displayed, the on-screen keyboard disappears as shown in Figure 5-5, and the IME moves to the top of the screen.
When the user switches to the Samsung Smart Control, standard remote, Motion Control, or a mouse to select the Input Window, the original IME will be displayed again.
Figure 5-5. Input method using keyboards
5.3. IME Categorization
There are several different types of Samsung IME, which appear depending on the purpose of the text input.
General Text Input
The format most commonly used within applications. All supported characters (letters, numbers, and special characters) can be entered. The language can also be changed. Recommended words will be provided based on the input.
Figure 5-6. General Text Input
The format used for entering passwords. Recommended words will not be not provided. The show/hide password feature can be used to show or hide the characters entered on the screen, as required.
Figure 5-7. Password input
English only input
The format when only the characters in the English alphabet can be entered.
Figure 5-8. English only input
Numbers only input
The format when only numbers can be entered.
Figure 5-9. Numbers only input
5.4. IME for Consecutive Input
The Samsung IME supports entering two or more input items without the IME turning off.
For consecutive inputs, the Next button is provided instead of Done on the On-screen Keyboard. Selecting the Next button while entering text will complete the current item, and the IME will change to fit the next item. For the last item on Consecutive Input, the Done button will be provided instead of Next.
e.g. When entering the username and password consecutively in order When Next is selected on the IME for username input, the input will
be completed. The IME will then change to fit password input.
Figure 5-10. When entering the use name and password consecutively in order