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

Note:

The feature is available for RHEL 7.x, CentOS 7.x, Ubuntu 16.04, Ubuntu 18.04, and SUSE 12.x. It is supported on Citrix Workspace app for Windows and for Mac.

To use the feature in RHEL 7.x desktop sessions, you must enable IBus. For example, set the user interface language to one that requires an IME to input, or add GTK_IM_MODULE=ibus to the ${HOME}/.config/imsettings/xinputrc file.

The feature installs automatically, but you must enable the feature 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 the Client Keyboard Layout Sync and IME Improvement policy or edit the registry through the ctxreg utility.

Note:

The Client Keyboard Layout Sync and IME Improvement policy 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 the Client Keyboard Layout Sync and IME Improvement policy to enable or disable the client IME user interface synchronization feature:

    1. In Studio, right-click Policies and select Create Policy.
    2. Search for the Client Keyboard Layout Sync and IME Improvement policy.

      Image of the Client Keyboard Layout Sync and IME Improvement policy

    3. Click Select next 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: disables 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 the SyncKeyboardLayout registry key at HKEY_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 the SyncKeyboardLayout and SyncClientIME registry keys at HKEY_LOCAL_MACHINE\SYSTEM \CurrentControlSet\Control\Citrix\LanguageBar.
  • Edit the registry through the ctxreg utility 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"
     <!--NeedCopy-->
    

    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"
     <!--NeedCopy-->
    
Client IME user interface synchronization