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).

image.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:
image.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.

image.png

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

Hotkey Hotkey function Take effect on local/client or host/VDA Apply to virtual app/desktop Notes
Hotkey1Char=
Hotkey1Shift=
Windows
key 
Refers to
Task List
on CWA
side group
policy
setting
option
Local App
Desktop
(need to
modify to
Connection
Bar=0 in .ica
file)
If we configure from CWA client group policy, default
setting is "Shift + F1"
image.png
Hotkey2Char=
Hotkey2Shift=
Close Citrix
session window
Local App Desktop
(need to
modify to
Connection
Bar=0 in .ica
file)
If we configure from CWA client group policy, default

setting is "Shift + F3"
image.png
Hotkey3Char=
Hotkey3Shift=
Toggle full-
screen or
windowed
mode
Local Desktop
(need to
modify to
Connection
Bar=0 in .ica
file)
If we configure from CWA client group policy, default
setting is "Shift + F2"
image.png
Hotkey4Char=
Hotkey4Shift=
Ctrl+Alt+De
lete
VDA App
Desktop
(need to
modify to
Connection
Bar=0 in .ica
file)
Shows this screen of Windows
image.png
If we configure from CWA client group policy, default
setting is "Shift + F1"
image.png
Hotkey5Char=
Hotkey5Shift=
Open Task
Manager
VDA App
Desktop
(need to
modify to
Connection
Bar=0 in .ica
file)
If we configure from CWA client group policy, default
setting is "Shift + F3"
image.png
Hotkey6Char=
Hotkey6Shift=
Alt + Tab VDA App
Desktop 
(need to
modify to
Connection
Bar=0 in .ica
file)
If we configure from CWA client group policy, default
setting is "Shift + F8"
image.png
Hotkey7Char=
Hotkey7Shift=
Alt + Shift +
Tab
VDA App
Desktop
(need to
modify to
Connection
Bar=0 in .ica
file)
If we configure from CWA client group policy, default
setting is "Shift + F9"
image.png
 
Hotkey8Char=
Hotkey8Shift=
Ctrl + Esc VDA App
Desktop
(need to
modify to
Connection
Bar=0 in .ica
file)
If we configure from CWA client group policy, default
setting is "Shift + F2"
image.png
Hotkey9Char=
HotKey9Shift=
Ctrl + Alt VDA App
Desktop
(need to
modify to
Connection
Bar=0 in .ica
file)
If we configure from CWA client group policy, default
setting is "Shift + F2"
image.png
Hotkey13Char=
Hotkey13Shift=
Minimize
session
window
VDA Desktop
(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
Local Desktop
(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"
image.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+F12 Local Application 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

 

 

Issue/Introduction

Citrix Workspace App for Windows - Shortcut or Hotkey redirection