On Key Char
UserWidgetЧто это
Событие (Event) в UserWidget, вызывается при вводе символа с клавиатуры (с учётом раскладки, регистра и модификаторов). Не является pure-функцией: срабатывает автоматически, не требует execute-входа.
Пины
Exec-входы:
— нет (событие)
Exec-выходы:
- then (exec) — продолжение выполнения после обработки события
Входы (данные):
- In Character Event (Character Event) — структура, содержащая введённый символ (Key), модификаторы клавиш и другую информацию о событии
Выходы (данные):
- Return Value (Boolean) — если
true, событие считается обработанным и не передаётся дальше по цепочке виджетов; еслиfalse— событие может быть обработано другими слушателями
Когда используется
Для перехвата и обработки текстового ввода в пользовательских элементах интерфейса: поля ввода (TextBox), поисковые строки, фильтры, а также для создания горячих клавиш, которые должны срабатывать на конкретные символы (например, «Enter», «Escape»).
Типичные проблемы
- Если событие не подключено вообще или возвращает
false, виджет не сможет перехватить символ — он уйдёт в родительские виджеты или в основной обработчик. - Путаница с событием
OnKeyDown: последнее ловит физические клавиши (коды клавиш, Virtual Key), тогда какOnKeyCharловит именно символы (Unicode), включая точки, запятые, буквы разных регистров и раскладок.