Configure a custom keyboard

Configure a custom keyboard

Configure a custom virtual keyboard by adding a Keyboard object and adjusting its children objects and properties.
Prerequisites
Select the custom virtual keyboard engine by setting
Virtual keyboard
 to
Custom
. See Configure presentation engines.
  1. To configure a custom keyboard
  2. In
    Project view
    , expand
    UI
    , right-click
    Keyboards
     and select
    Keyboard
    .
    TIP: You can import a predefined keyboard from template libraries if you do not want to add all keyboard keys from scratch. You can modify the imported keyboard at any point. For more information, see Import a template.
  3. In
    Properties
    , set keyboard options:
    • Locales
      . Locales for which to use this virtual keyboard. For more information, see Sessions and locales.
      TIP: If you do not specify a custom keyboard for the current locale, FactoryTalk Optix uses the first available keyboard following the
      Locales fallback
       property of the project object.
    • Keyboard type
      .
      Alphanumeric
      ,
      Numeric
       or a custom keyboard type.
      For example, set
      Keyboard type
       to
      CustomKeyboard
    • Preedit control
      . Dynamic link to a graphic object that displays the text to be applied after editing is complete. For example, a dynamic link to a text box.
      For more information about dynamic links, see Create dynamic links.
  4. In
    Project view
    , to add keyboard keys, right-click the keyboard and select either:
    • Keyboard text button
       and then, in
      Properties
      , enter a character in
      Key
      .
      For example, enter
      q
       in
      Key
      .
      TIP:
      The characters are automatically uppercase or lowercase based on the
      ShiftActive
       property value of the Shift keyboard key. You can also use the
      ShiftActive
       value in your application logic.
      You cannot use emoticons for
      Key
       characters.
    • Keyboard symbol button
       and then, in
      Properties
      , select a symbol.
      For example, select
      Enter
       from
      Symbol
      .
  5. (optional) In
    Properties
    , modify the
    Size and layout
     and
    Appearance
     properties of the keyboard.
  6. (optional) In
    Project view
    , expand the keyboard object and manage the children objects.
    TIP:
    For example you can:
Implement the custom keyboard into your project. See Select a keyboard.
Provide Feedback
Have questions or feedback about this documentation? Please submit your feedback here.