Citrix Workspace App for Windows - Shortcut or Hotkey redirection

Citrix Workspace App for Windows - Shortcut or Hotkey redirection

book

Article ID: CTX583924

calendar_today

Updated On:

Description

    CWA Windows provides 2 approaches to configure the hotkey redirection: Storefront configuration and client side configuration.


    Instructions

    What is a keyboard shortcut or hotkey

    A series of one or several keys to quickly invoke a software program or perform a preprogrammed action.

    • For shortcut/hotkey which contains only 1 key, it's straightforward that Citrix Workspace App (CWA) can send this key to VDA directly via Unicode/Scancode.
    • For shortcut/hotkey which contains 2 or more keys, e.g. Ctrl + C, VDAs & CWAs need to handle them specifically.  Especially when the shortcut/hotkey is a system shortcut/hotkey on the client OS.

    What is shortcut/hotkey redirection

    • Hotkey redirection is actually a way to use customized shortcuts to perform needed functions in a Citrix application or desktop session with CVAD.

    Shortcut or hotkey redirection in CWA Windows

    Citrix provides approach to configure hotkey redirections.  There are 2 approaches available now: Storefront configuration and client configuration.

    Storefront Configuration

    1. Locate the default.ica file from \inetpub\wwwroot\Citrix\Store\App_Data (If Web Interface 4.x or later is used, otherwise locate Template.ica).

    pix1.png

    1. Copy the following ICA parameters to the default.ica file after the [WFCLIENT] tag, and configure the keys for them based on preference:

    Hotkey1Char=
    Hotkey1Shift=
    Hotkey2Char=
    Hotkey2Shift=
    Hotkey3Char=
    Hotkey3Shift=
    Hotkey4Char=
    Hotkey4Shift=
    Hotkey5Char=
    Hotkey5Shift=
    Hotkey6Char=
    Hotkey6Shift=
    Hotkey7Char=
    Hotkey7Shift=
    Hotkey8Char=
    Hotkey8Shift=
    Hotkey9Char=
    HotKey9Shift=
    Hotkey10Char=
    HotKey10Shift=
    Hotkey11Char=
    Hotkey11Shift=
    Hotkey12Char=
    Hotkey12Shift=
    Hotkey13Char=              
    Hotkey13Shift=
    Hotkey14Char=
    Hotkey14Shift=
    Hotkey15Char=
    Hotkey15Shift= 

    Hotkey**Shift: we can use Ctrl/Shift/Alt
    Hokey**Char: we can use F1/F2/F3/F4/F5/F6/F7/F8/F9/F10/F11/F12/minus/plus/star/tab


    For example:
    pix2.png

    Client configuration (has higher priority than Storefront configuration)

    1. In the CWA Windows client, go to Local Group Policy Editor.
    2. Locate "Administrative Templates" -> "Citrix Workspace" -> "User Experience" -> "Keyboard shortcuts", double-click then enable the policy and check the default settings.
    3. If the default hotkey settings are modified then a reboot of CWA is required to take effect.

    pix3.png

    Below is a table that shows how these customized hotkeys work:

    HotkeyHotkey functionTake effect on local/client or host/VDAApply to virtual app/desktopNotes
    Hotkey1Char=
    Hotkey1Shift=
    Windows
    key 
    Refers to
    Task List
    on CWA
    side group
    policy
    setting
    option
    LocalApp
    Desktop
    (need to
    modify to
    Connection
    Bar=0 in .ica
    file)
    If we configure from CWA client group policy, default
    setting is "Shift + F1"
    pix4.png
    Hotkey2Char=
    Hotkey2Shift=
    Close Citrix
    session window
    LocalApp Desktop
    (need to
    modify to
    Connection
    Bar=0 in .ica
    file)
    If we configure from CWA client group policy, default

    setting is "Shift + F3"
    pix5.png
    Hotkey3Char=
    Hotkey3Shift=
    Toggle full-
    screen or
    windowed
    mode
    LocalDesktop
    (need to
    modify to
    Connection
    Bar=0 in .ica
    file)
    If we configure from CWA client group policy, default
    setting is "Shift + F2"
    pix6.png
    Hotkey4Char=
    Hotkey4Shift=
    Ctrl+Alt+De
    lete
    VDAApp
    Desktop
    (need to
    modify to
    Connection
    Bar=0 in .ica
    file)
    Shows this screen of Windows
    pix7.png
    If we configure from CWA client group policy, default
    setting is "Shift + F1"
    pix8.png
    Hotkey5Char=
    Hotkey5Shift=
    Open Task
    Manager
    VDAApp
    Desktop
    (need to
    modify to
    Connection
    Bar=0 in .ica
    file)
    If we configure from CWA client group policy, default
    setting is "Shift + F3"
    pix9.png
    Hotkey6Char=
    Hotkey6Shift=
    Alt + TabVDAApp
    Desktop 
    (need to
    modify to
    Connection
    Bar=0 in .ica
    file)
    If we configure from CWA client group policy, default
    setting is "Shift + F8"
    pix10.png
    Hotkey7Char=
    Hotkey7Shift=
    Alt + Shift +
    Tab
    VDAApp
    Desktop
    (need to
    modify to
    Connection
    Bar=0 in .ica
    file)
    If we configure from CWA client group policy, default
    setting is "Shift + F9"
    pix11.png
     
    Hotkey8Char=
    Hotkey8Shift=
    Ctrl + EscVDAApp
    Desktop
    (need to
    modify to
    Connection
    Bar=0 in .ica
    file)
    If we configure from CWA client group policy, default
    setting is "Shift + F2"
    pix12.png
    Hotkey9Char=
    HotKey9Shift=
    Ctrl + AltVDAApp
    Desktop
    (need to
    modify to
    Connection
    Bar=0 in .ica
    file)
    If we configure from CWA client group policy, default
    setting is "Shift + F2"
    pix13.png
    Hotkey13Char=
    Hotkey13Shift=
    Minimize
    session
    window
    VDADesktop
    (need to
    modify to
    Connection
    Bar=0 in .ica
    file)
    There is no Group Policy setting options available in
    CWA client group policy setting.

    We only support configuring from Storefront default.ica
    file.
    Hotkey14Char=
    Hotkey14Shift=
    Local IME
    toggle
    LocalDesktop
    (need to
    modify to
    Connection
    Bar=0 in .ica
    file)
    The hotkey of generic IME mode is only available
    when the user enables the local keyboard, enables
    the generic IME feature and the current input
    language is CKJ languages.

    If we configure from CWA client group policy, default
    setting is "Shift + F4"
    pix14.png
    Hotkey10Char=
    HotKey10Shift=
    Latency
    Reduction
      /  /Depreciated
    Hotkey11Char=
    Hotkey11Shift=
      /  /  /Reserved
    Hotkey12Char=
    Hotkey12Shift=
      /  /  /Reserved
    Hotkey13Char=
    Hotkey13Shift=
    ///

    In legacy versions of Citrix receiver this minimized the session window. As of Receiver 10.214 this functionality was removed and the key is always passed through to the client.

    Hotkey15Char=
    Hotkey15Shift=
    Ctrl+F12LocalApplication and desktops, Note : Relative Mouse functionality is not supported when in seamless application mode 

    Keyboard shortcut for toggling Relative Mouse on/off to improve mouse experience.
    If we configure from CWA client group policy, default
    setting is "Ctrl + F12