Name: controlKeyDown

Type: message

Syntax: controlKeyDown <pKeyName>

Summary:

Sent when a Control <key combination> is pressed.

Associations: card, field

Introduced: 1.0

OS: mac, linux

Platforms: desktop, server

Example:

on controlKeyDown pKey -- make Control-D delete the current card

if pKey is "D" then

delete this card

else

pass controlKeyDown

end if

end controlKeyDown

Parameters:

pKeyName:

The actual character of the pressed key.

Description:

Handle the <controlKeyDown> <message> if you want to provide Control-key

shortcuts on <Mac OS|Mac OS systems>.

The message is sent to the active (focused) control, or to the current

card if no control is focused.

If the Control key is pressed along with the Return key, Tab key, or

Enter key, or with an arrow key, no <controlKeyDown> <message> is sent.

Instead, the <returnKey>, <tabKey>, <enterKey>, or <arrowKey> <message>

is sent. To trap a combination such as Control-Return, use a <returnKey>

<handler> and check the <controlKey> <function> inside the <handler>.

>*Cross-platform note:* On <Mac OS|Mac OS systems>, the

> <controlKeyDown> <message> is sent when a control <key combination> is

> pressed. On <Windows|Windows systems>, a control <key combination>

> sends a <commandKeyDown> message instead, and the <controlKeyDown>

> <message> is never sent. On <Unix|Unix systems>, the <controlKeyDown>

> <message> is sent only if Mod2 has been defined.

References: function (control structure), controlKey (function),

keysDown (function), handler (glossary), Windows (glossary),

key combination (glossary), message (glossary), Mac OS (glossary),

Unix (glossary), enterKey (message), optionKeyDown (message),

tabKey (message), commandKeyDown (message), keyDown (message),

arrowKey (message), returnKey (message)

Tags: ui