Студия/OnKeyPress - Revision history

Admin: 1 revision imported

2021-11-20T17:10:03Z

1 revision imported

1>Admin at 11:28, 2 August 2021

2021-08-02T11:28:53Z

Admin: 1 revision imported

2021-02-07T06:55:41Z

1 revision imported

Admin: Created page with "{{infobox function |name=OnKeyPress |element=Список значений, Таблица значений, Дерево значений |caption=Визуальные соб..."

2020-08-23T06:54:57Z

Created page with "{{infobox function |name=OnKeyPress |element=Список значений, Таблица значений, Дерево значений |caption=Визуальные соб..."

New page

{{infobox function
|name=OnKeyPress
|element=Список значений, Таблица значений, Дерево значений
|caption=Визуальные события
|eventtype=Прерывающее
|status=2}}
{{HeadLinks|
* [[Main_Page|Начальная страница]]
* [[Студия/Редактор форм|Редактор форм]]
* [[Студия/Визуальные события|Визуальные события]]}}
Событие, возникающее при нажатии на клавишу клавиатуры, когда текущий элемент активен. Не все комбинации могут быть пойманы в этом событии. Это событие используется для табличных элементов, для полей используется событие [[Студия/OnBeforeChange|OnBeforeChange]].

==== Аргументы ====
* <code>''<Key (INT)>''</code> - Виртуальный код нажатой клавиши (см. документацию Windows, используются коды клавиш, типа <code>VK_BACK</code> и т.п.). Большинство цифровых или литерных клавиш имеет коды, совпадающие с кодами ASCII.
* <code>''<KeyCombo (STRING)>''</code> - Визуальное представление нажатой клавиши совместно с клавишами модификаторами. К примеру, <code>"Ctrl+A"</code>. Для проверки активности клавиш-модификаторов можно также использовать функцию [[IsKeyComboActive]].
* <code>''<Result (INT)>''</code> - {{ByRef}} Переменная результата может принимать значения:
** '''0''' (по умолчанию) -- Принять нажатие (разрешить передачу этого нажатия клавиши активному элементу формы).
** '''1''' -- Отвергнуть нажатие (нажатие клавиши будет проигнорировано).

== Примеры ==
<pre>
//Эмуляция поведения при нажатии Ctrl+Up, Ctrl+Down в таблице, где работа с папками задается программно (к примеру, отображается файловая система).
//Ctrl+Up
MainTab:=Form.MainTab.Value;
If (Key=38)And(IsKeyComboActive("Ctrl")) Then
Result:=1;
//Выйти из текущего уровня, если он не верхний
If спУровень.Size()>0 Then
iNum:=спУровень.Size();
ТекЭлемент:=спУровень.Get(iNum);
//Создать отображение всего пути
ТекПапка:="";
For i:=1 To iNum-1 Do
ТекПапка:=ТекПапка+спУровень.Get(i)+"\";
EndDo;
ОбновитьТаблицу();
EndIf;
//Ctrl+Down
ElseIf (Key=40)And(IsKeyComboActive("Ctrl")) Then
//Тоже самое, что Enter, если курсор находится на папке
Result:=1;
If MainTab.SelectedLine=0 Then
Exit;
EndIf;
MainTab.CurLine:=MainTab.SelectedLine;
//Проверим, находимся ли мы на папке (с помощью номера иконки, к примеру)
If MainTab.Icon(MainTab.CurLine,"Иконка")=98 Then
ТекЭлемент:=MainTab.Наименование;
ТекПапка:=ТекПапка+MainTab.Наименование+"\";
ОбновитьТаблицу();
EndIf;
EndIf;
</pre>

← Older revision	Revision as of 17:10, 20 November 2021
(No difference)

@@ Line 1: / Line 1: @@
 {{infobox function
 |name=OnKeyPress
-|element=Список значений, Таблица значений, Дерево значений
+|element=Форма, Список значений, Таблица значений, Дерево значений
 |caption=Визуальные события
 |eventtype=Прерывающее
@@ Line 9: / Line 9: @@
 * [[Студия/Редактор форм|Редактор форм]]
 * [[Студия/Визуальные события|Визуальные события]]}}
-Событие, возникающее при нажатии на клавишу клавиатуры, когда текущий элемент активен. Не все комбинации могут быть пойманы в этом событии. Это событие используется для табличных элементов, для полей используется событие [[Студия/OnBeforeChange|OnBeforeChange]].
+Событие, возникающее при нажатии на клавишу клавиатуры, когда текущий элемент или форма активны. Не все комбинации могут быть пойманы в этом событии. Это событие используется для табличных элементов, для полей используется событие [[Студия/OnBeforeChange|OnBeforeChange]]. '''Важно''': для формы используется более сложный механизм отлова нажатия, под Windows это приводит к тому, что во время исполнения события строго не рекомендуется изменение графических свойств формы. Система пытается обойти это ограничение, однако, без реальной необходимости обработчик должен совершить невизуальные действия и вернуть управление.
 ==== Аргументы ====
-* <code>''<Key (INT)>''</code> - Виртуальный код нажатой клавиши (см. документацию Windows, используются коды клавиш, типа <code>VK_BACK</code> и т.п.). Большинство цифровых или литерных клавиш имеет коды, совпадающие с кодами ASCII.
+* <code>''<Key (INT)>''</code> - Виртуальный код нажатой клавиши (см. документацию Windows, используются коды клавиш, типа <code>VK_BACK</code> и т.п.). Большинство цифровых или литерных клавиш имеют коды, совпадающие с кодами ASCII.
 * <code>''<KeyCombo (STRING)>''</code> - Визуальное представление нажатой клавиши совместно с клавишами модификаторами. К примеру, <code>"Ctrl+A"</code>. Для проверки активности клавиш-модификаторов можно также использовать функцию [[IsKeyComboActive]].
 * <code>''<Result (INT)>''</code> - {{ByRef}} Переменная результата может принимать значения:
 ** '''0''' (по умолчанию) -- Принять нажатие (разрешить передачу этого нажатия клавиши активному элементу формы).

← Older revision	Revision as of 06:55, 7 February 2021
(No difference)