livecode/docs/dictionary/message/arrowKey.lcdoc at develop-8.1 · livecode/livecode

This repository was archived by the owner on Aug 31, 2021. It is now read-only.

61 lines (44 loc) · 1.88 KB

Name: arrowKey
Type: message
Syntax: arrowKey pKey
Sent to the <active control(glossary)>, or to the <current card> if no
<control> is <focus|focused>, when the user presses an arrow key.
Introduced: 1.0
Associations: card, field
OS: mac, windows, linux
Platforms: desktop, server
on arrowKey theKey -- make Up arrow go to the first card
  if theKey is "up" then go to card 1
  else pass arrowKey
end arrowKey
Parameters:
pKey (enum):
- "up": The up arrow key
- "down": The down arrow key
- "left": The left arrow key
- "right": The right arrow key
Description:
The parameter indicates which arrow key was pressed.
Handle the <arrowKey> <message> if you want to do something special when
the user presses an arrow key.
If the <arrowKey> <handler> does not <pass> the <message> or <send> it
to a further <object(glossary)> in the <message path>, LiveCode does not
perform the usual arrow key action (moving the <insertion point>, moving
the <selected> <object(glossary)>, or navigating to another card).
<pass|Passing> the <message> lets the arrow key action take place.
If the focused control is part of a group, and the group's
tabGroupBehavior <property> is set to true, no <arrowKey> <message> is
sent when the user presses an arrow key.
>*Note:* Sending an <arrowKey> message does nothing unless there is an
> <arrowKey> <handler> in the <message path>. This is a difference from
> <HyperCard|HyperTalk's> handling of the <arrowKey> <message>.
References: send (command), pass (control structure), property (glossary),
current card (glossary), handler (glossary), focus (glossary),
message path (glossary), pass (glossary), insertion point (glossary),
message (glossary), HyperCard (glossary), active control (glossary),
object (glossary), control (keyword), functionKey (message),
selectionChanged (message), navigationArrows (property),
textArrows (property), selected (property)

Navigation Menu

Uh oh!

Uh oh!

FilesExpand file tree

arrowKey.lcdoc

Latest commit

History

arrowKey.lcdoc

File metadata and controls