Функция READKEY( )

Возвращает значение, которое соответствует клавише, нажатой для выхода из екоторых команд редактирования, или значение, указывающее, как закончилась послед яя команда READ. Включена для совместимости с предыдущими версиями. Используйте Конструктор форм вместо команды READ.

Синтаксис

READKEY([nExpression])

Параметры

nExpression

Функция READKEY( ) возвращает значение, указывающее, как завершилась последняя команда READ. nExpression может задавать любое значение.

В следующей таблице перечислены значения, возвращаемые функцией READKEY( ), и причины прекращения READ.

Значение	Причина
1	Ни одна из нижеперечисленных
2	Выдана команда CLEAR READ
3	Выбран прекращающий элемент управления
4	Окно READ закрыто
5	Предложение DEACTIVATE возвратило .T.
6	Комманда READ прекращена по таймауту

Результат

Числовой

Комментарии

Если выдать функцию READKEY( ) без аргумента nExpression, то возвращаемое значение будет представлять клавишу, нажатую для выхода из с едующих команд редактирования: APPEND, BROWSE, CREATE, EDIT, INSERT, MODIFY и READ.

Функция READKEY( ) возвращает целое число в диапазоне от 0 до 36, если данные е изменились, или в диапазоне от 256 до 292, если данные изменились. В сле ующей таблице перечислены значения, возвращаемые функцией READKEY( ):

Клавиша (клавиши)

Код в отсутствие обновления

Код в случае обновления

Backspace стрелка влево Ctrl+H Ctrl+S	0	256
стрелка вправо Ctrl+D* Ctrl+L	1	257
Home Ctrl+A*	2	258
End Ctrl+F	3	259
стрелка вверх Ctrl+E* Shift+Tab Ctrl+K*	4	260
стрелка вниз Ctrl+X* Tab Ctrl+Enter Ctrl+I Ctrl+J	5	261
Page Up Ctrl+R*	6	262
Page Down Ctrl+C	7	263
Ctrl+ стрелка влево	8	264
Ctrl+Q Esc	12	268
Ctrl+End Ctrl+W	-	270
Enter Ctrl+стрелка вправо Ctrl+M	15	271
Timeout	20	276
Ctrl+Home Ctrl+]	33	289
Ctrl+Page Up Ctrl+_	34	290
Ctrl+Page Down Ctrl+^	35	291
F1	36	292

*Если установка SET SYSMENU имеет значение OFF или загружен файл FOXPLUS.FKY, ти значения возвращаются. В предыдущих версиях FoxPro файл FOXPLUS.FKY можно б ло найти в каталоге GOODIES. Файл FOXPLUS.FKY не включается в комплект Visual FoxPro.

В FoxPro для Macintosh функция READKEY( ) поддерживает также командную клавишу . Чтобы задать командную клавишу , используйте клавишу Cmd. Командные клавиши Control (Ctrl) и в FoxPro для Macintosh эквивалентны. Однако если приложение будет работать на других платформах FoxPro, по соображениям совместимости лучше использовать Ctrl. Подробнее о клавиатуре и клавишах в FoxPro для Macintosh см. в разделе Keyboard Differences документа Installation and Macintosh Features Guide.

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

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

Клавиша Alt, используемая в FoxPro для MS-DOS и Visual FoxPro, эмулируется в FoxPro для Macintosh с помощью клавиш Ctrl+Option.