Linux Virtual Delivery Agent

Client IME user interface synchronization

Overview

To date, the client IME user interface (including the composition window and candidate window) was positioned in the upper left corner of the screen. It did not follow the cursor and sometimes was located far from the cursor in the text input area:

Image of previous client IME user interface

Citrix enhances usability and further improves the user experience with the client IME as follows:

Image of current client IME user interface

Prerequisites for using the feature

  1. Enable Intelligent Input Bus (IBus) on your Linux VDA. For information on how to enableIBuson a Linux OS, see the OS vendor’s documentation. For example:
  2. The feature installs automatically but you must enable it before you can use it.

Enable and disable the feature

The client IME user interface synchronization feature is disabled by default. To enable or disable the feature, set theClient Keyboard Layout Sync and IME Improvementpolicy or edit the registry through thectxregutility.

Note:

TheClient Keyboard Layout Sync and IME Improvementpolicy takes priority over registry settings and can be applied to user and machine objects you specify or all objects in your site. Registry settings on a given Linux VDA apply to all sessions on that VDA.

  • Set theClient Keyboard Layout Sync and IME Improvementpolicy to enable or disable the client IME user interface synchronization feature:

    1. In Studio, right-clickPoliciesand selectCreate Policy.
    2. Search for theClient Keyboard Layout Sync and IME Improvementpolicy.

      Image of the Client Keyboard Layout Sync and IME Improvement policy

    3. ClickSelectnext to the policy name.
    4. Set the policy.

      Image of setting the Client Keyboard Layout Sync and IME Improvement policy

      There are three options available:

      • Disabled:禁用dynamic keyboard layout synchronization and client IME user interface synchronization.
      • Support dynamic client keyboard layout synchronization: enables dynamic keyboard layout synchronization regardless of the DWORD value of theSyncKeyboardLayoutregistry key atHKEY_LOCAL_MACHINE\SYSTEM \CurrentControlSet\Control\Citrix\LanguageBar.
      • Support dynamic client keyboard layout synchronization and IME improvement: enables both dynamic keyboard layout synchronization and client IME user interface synchronization regardless of the DWORD values of theSyncKeyboardLayoutandSyncClientIMEregistry keys atHKEY_LOCAL_MACHINE\SYSTEM \CurrentControlSet\Control\Citrix\LanguageBar.
  • Edit the registry through thectxregutility to enable or disable the client IME user interface synchronization feature:

    To enable the feature, run the command:

    /opt/Citrix/VDA/bin/ctxreg update -k "HKEY_LOCAL_MACHINE\System\CurrentControlSet\Control\Citrix\LanguageBar" -v "SyncClientIME" -d "0x00000001" 

    To disable the feature, run the command:

    /opt/Citrix/VDA/bin/ctxreg update -k "HKEY_LOCAL_MACHINE\System\CurrentControlSet\Control\Citrix\LanguageBar" -v "SyncClientIME" -d "0x00000000" 
Client IME user interface synchronization