Configure Key Overrides
In a key override, specific keystrokes send custom-defined key combinations to the VMs.
You add key overrides when you customize your Environment Viewer. Key overrides will affect all VM tabs that are accessed by that viewer.
Note
The key overrides feature requires CloudShare's Smart Access remote access protocol to be enabled for the account. The feature is not supported by older remote access protocols, such as Gateway remote access. Please contact CloudShare Support should you require assistance.
To configure key overrides:
Go to the Customize Environment Viewer page for the environment you want to customize (Environment Details > Edit Environment > Customize Viewer).
Switch to Custom Settings in the Apply Settings from dropdown.
In Advanced Mode, click the Overview tab. The HTML editor for the tab is opened for editing at the right.
-
Add a key-overrides tag anywhere on the HTML page, specifying all the custom mappings you want, as in the following example:
<key-overrides key-overrides="{key-code}:{key-value},{key-code}:{key-value},...,{key-code}:{key-value}"></key-overrides>
where:
{key-code}
is the JavaScript key code for the key you want to override.-
{key-value}
is either a single keystroke or a key combination that you want to send to the remote VM when the overridden key is pressed. Specify combinations by inserting "+" between keys.The following values are valid for keys: meta key (Windows key on Windows), ctrl, alt, delete, space, f1, f2, ..., f23, f24, tab, backspace, shift, home, insert. If a value is specified that is not recognized as a key, it is sent as text. Case does not matter.
For example, in the following tag example:
<key-overrides key-overrides="97:Ctrl+Tab,98:Ctrl+Shift+Tab,99:ctrl+t"></key-overrides>
The "1" key on the number pad (JavaScript code 97) sends the key combination CTRL+TAB to the VM (which switches to the next tab inside a browser running on the VM).
The "2" key on the number pad (JavaScript code 98) sends the key combination CTRL+SHIFT+TAB to the VM (which switches to the previous tab inside a browser running on the VM).
The "3" key on the number pad (JavaScript code 99) sends the key combination CTRL+T to the VM (which opens a new tab in a browser)
Click Save in the Customize Environment Viewer page to save the customization.
Once key overrides are configured for a given environment, you can use them under the following conditions:
You must be using the Environment Viewer in regular mode, not in fullscreen mode.
You must visit the Overview tab in the environment at least once in the session before you enter the key.
-
Before you issue the relevant keystroke, make sure your current focus is on the entity you want to affect on the remote VM.
For example, if you want to use a key override that maps numpad 1 to the ALT+F4 key combination, which closes a window, first make sure that the window on the VM that you want to close is the active focus and only then press the "1" key on the numpad.
Key |
Code |
Key |
Code |
Key |
Code |
---|---|---|---|---|---|
backspace |
8 |
e |
69 |
numpad 8 |
104 |
tab |
9 |
f |
70 |
numpad 9 |
105 |
enter |
13 |
g |
71 |
multiply |
106 |
shift |
16 |
h |
72 |
add |
107 |
ctrl |
17 |
i |
73 |
subtract |
109 |
alt |
18 |
j |
74 |
decimal point |
110 |
pause/break |
19 |
k |
75 |
divide |
111 |
caps lock |
20 |
l |
76 |
f1 |
112 |
escape |
27 |
m |
77 |
f2 |
113 |
(space) |
32 |
n |
78 |
f3 |
114 |
page up |
33 |
o |
79 |
f4 |
115 |
page down |
34 |
p |
80 |
f5 |
116 |
end |
35 |
q |
81 |
f6 |
117 |
home |
36 |
r |
82 |
f7 |
118 |
left arrow |
37 |
s |
83 |
f8 |
119 |
up arrow |
38 |
t |
84 |
f9 |
120 |
right arrow |
39 |
u |
85 |
f10 |
121 |
down arrow |
40 |
v |
86 |
f11 |
122 |
insert |
45 |
w |
87 |
f12 |
123 |
delete |
46 |
x |
88 |
num lock |
144 |
o |
48 |
y |
89 |
scroll lock |
145 |
1 |
49 |
z |
90 |
semi-colon |
186 |
2 |
50 |
left window key |
91 |
equal sign |
187 |
3 |
51 |
right window key |
92 |
comma |
188 |
4 |
52 |
select key |
93 |
dash |
189 |
5 |
53 |
numpad 0 |
96 |
period |
190 |
6 |
54 |
numpad 1 |
97 |
forward slash |
191 |
7 |
55 |
numpad 2 |
98 |
grave accent |
192 |
8 |
56 |
numpad 3 |
99 |
open bracket |
219 |
9 |
57 |
numpad 4 |
100 |
back slash |
220 |
a |
65 |
numpad 5 |
101 |
close bracket |
221 |
b |
66 |
numpad 6 |
102 |
single quote |
222 |
c |
67 |
numpad 7 |
103 |
||
d |
68 |
Comments
0 comments
Article is closed for comments.