Команда ON KEY LABEL

Задает команду, которая будет выполнена, если нажать некоторую клавишу или ком инацию клавиш или щелкнуть кнопкой мыши.

Синтаксис

ON KEY [LABEL KeyLabelName] [Command]

Параметры

LABEL KeyLabelName

Задает название клавиши. KeyLabelName представляет собой букву или цифру, изображенную на клавише, или присвоенное ей специальное имя. В следующей таблице перечислены именно такие названия к авиш специальные имена. Следом за ней приведена таблица с исключениями для FoxPro ля Macintosh.

Названия клавиш в Visual FoxPro

Клавиша	KeyLabelName
	LEFTARROW
	RIGHTARROW
	UPARROW
	DNARROW
Home	HOME
End	END
Page Up	PGUP
Page Down	PGDN
Del	DEL
Backspace	BACKSPACE
Spacebar	SPACEBAR
Ins	INS
Tab	TAB
Shift Tab	BACKTAB
Enter	ENTER
F1 F12	F1, F2, F3 ...
Ctrl+F1 Ctrl+F12	Ctrl+F1, Ctrl+F2 ...
Shift+F1 Shift+F12	Shift+F1, Shift+F2 ...
Alt+F1 Alt+F12	Alt+F1, Alt+F2, Alt+F3 ...
Alt+0 Alt+9	Alt+0, Alt+1, Alt+2 ...
Alt+A Alt+Z	Alt+A, Alt+B, Alt+C ...
Ctrl+стрелка влево	Ctrl+LEFTARROW
Ctrl+стрелка вправо	Ctrl+RIGHTARROW
Ctrl+Home	Ctrl+HOME
Ctrl+End	Ctrl+END
Ctrl+Page Up	Ctrl+PGUP
Ctrl+Page Down	Ctrl+PGDN
Ctrl+A Ctrl+Z	Ctrl+A, Ctrl+B, Ctrl+C ...
CTRL+0	CTRL+0
праваЯ кнопка мыши	RIGHTMOUSE
леваЯ кнопка мыши	LEFTMOUSE
кнопка мыши	MOUSE
Esc	ESC

Исключения для FoxPro для Macintosh

Клавиша	KeyLabelName
Delete	DEL
Return	RETURN
	CMD или Ctrl
Alt	Ctrl+Option

Command

Задает команду, которая будет выполнена, если нажать заданную клавишу или ком инацию клавиш или щелкнуть кнопку мыши.

Комментарии

В команде ON KEY LABEL обычно используется команда DO, выполняющая нужную п оцедуру.

Во время работы команд READ, BROWSE, EDIT, CHANGE и пользовательских меню кома да ON KEY LABEL выполняет заданную команду немедленно. Если в момент нажатия к авиши или кнопки мыши выполнялась программа, Visual FoxPro выполняет текущую строку программы, а после нее команду ON KEY LABEL. Все назначения клавиш ON KEY LABEL, определенные в программе, остаются в силе после выполнения программы. В также можете определить назначения клавиш в окне команд.

Чтобы восстановить обычный режим работы некоторой клавиши, выдайте команду ON KEY LABEL KeyLabelName. Чтобы восстановить стандартный режим для всех клавиш, выдайте ON KEY.

Совет Чтобы избежать рекурсивных вызовов во время выполнения процедуры ON KEY LABEL, поставьте в начале процедуры команду PUSH KEY CLEAR, которая заблокирует все активные команды ON KEY LABEL. В конце процедуры выдайте команду POP KEY, возо новляющую действие команд ON KEY LABEL.

Назначения клавиш ON KEY LABEL не действуют в системной строке меню Visual FoxPro, в системных меню, диалоговых окнах, окнах предупреждения и т.п. Впрочем, ти назначения клавиш действуют в системных окнах Visual FoxPro текстовом редакторе Visual FoxPro, окне команд, окне трассировки и т.д.

В отличие от ON KEY, одновременно могут быть активны несколько команд ON KEY LABEL. Например, можно назначить команду каждой из клавиш со стрелками и кнопке мыши.

Следует отметить, что при выполнении команды ON KEY LABEL значение функции PARAMETERS( ) сбрасывается в 0. Подробнее об этом см. описание функции PARAMETERS( ).

В Visual FoxPro некоторые события нельзя перехватить, так как они находятся по контролем системы Windows. В частности, команды ON KEY LABEL MOUSE, ON KEY LABEL LEFTMOUSE и ON KEY LABEL RIGHTMOUSE не выполняются, если щелкнуть мышью такой элемент управления Windows, как управляющее меню, линейка прокрутки и т.п.

В FoxPro для Macintosh команда ON KEY LABEL поддерживает командную клавишу . Ее можно задать с помощью CMD. Командные клавиши Control (Ctrl) и в FoxPro для Macintosh эквивалентны друг другу. Однако если приложение будет аботать на других платформах FoxPro, используйте Ctrl по соображениям совместимости.

У мыши Macintosh только одна кнопка; поэтому если вы хотите выполнить команду, когда щелкаете мышью, то используйте ON KEY LABEL LEFTMOUSE или ON KEY LABEL MOUSE. Команда ON KEY LABEL RIGHTMOUSE используется для того, чтобы выполнить ужную команду, когда вы щелкаете мышью при нажатых клавишах +Option.

FoxPro для Macintosh также поддерживает в качестве назначения клавиши имя RETURN. Команда ON KEY LABEL RETURN эквивалентна команде ON KEY LABEL ENTER. Помимо этого, команда ON KEY LABEL DEL эквивалентна команде ON KEY LABEL BACKSPACE.

FoxPro для Macintosh использует клавиши Ctrl+Option для эмулирования функции клавиши Alt, используемой в Visual FoxPro, FoxPro для Windows и FoxPro для MS-DOS.

Подробнее о клавиатуре и клавишах в FoxPro для Macintosh см. раздел Keyboard Differences в документе Installation and Macintosh Features Guide.