KeyboardShortcut контроль

Стаття
03/21/2023

Елемент керування, який використовується для відстеження подій клавіатури та виконання дій у відповідь.

Нотатка

Повна документація та вихідний код ви знайдете у репозиторії компонентів коду GitHub.

Опис

Цей компонент коду реєструє обробники подій натискання клавіш клавіатури, щоб в компонованих програмах або на настроюваних сторінках можна було використовувати сполучення клавіш. Його не можна використовувати в модельних програмах або програмах порталу.

Властивості

Властивість	Опис
`KeyConfig`	Масив рядків, що вказує, які сполучення клавіш потрібно прослуховувати. Рядок потрібно серіалізувати за допомогою JSON (приклад наведено у наступному розділі).
`OnKey`	Виявлене сполучення клавіш.

Після додавання компонента коду KeyboardShortcuts до форми настройте властивість KeyConfig, задавши масив комбінацій клавіш.

Приклад.

["alt + r","alt + a","alt + d","alt + b","alt + p","alt + l","alt + t","alt + k"]

Щоб отримати додаткові відомості про рядки сполучень клавіш, перейдіть до розділу про бібліотеку KeyboardJS.

Поведінка

Реагування на події натискання клавіш

При натисканні комбінації клавіш ініціюється подія OnChange. До властивості OnKey вноситься використана комбінація клавіш.

Спробуйте встановити для події OnChange таке значення:

If( Self.OnKey = "alt + a",
    SetFocus(txtTextbox1)
);
If( Self.OnKey = "alt + r",
    UpdateContext({ ctxResizableTextareaEvent:"SetFocus" & Text(Rand()) })
);
If( Self.OnKey = "alt + b",
    SetFocus(txtTextbox2)
);
If( Self.OnKey = "alt + k",
    UpdateContext({ ctxPickerEvent:"SetFocus" & Text(Rand()) })
);
If( Self.OnKey = "alt + d",
    UpdateContext({ ctxDropdownEvent:"SetFocus" & Text(Rand()) })
);
If( Self.OnKey = "alt + l",
    UpdateContext({ ctxTagListEvent:"SetFocus" & Text(Rand()) })
);
If( Self.OnKey = "alt + t", 
    UpdateContext({ ctxTableEvent:"SetFocusOnRow" & Text(Rand()) })
);

Цей обробник подій задає фокус для різних елементів керування, відповідно до використаної комбінації клавіш.

Обмеження

Деякі сполучення клавіш використовуються Power Apps Studio під час редагування програми, а деякі – у браузері. З цієї причини цей компонент не працюватиме для деяких сполучень клавіш, доки користувач не перемістить фокус до програми.

Цей компонент коду можна використовувати лише в компонованих програмах і настроюваних сторінках.

Перегляньте інші примітки щодо обмежень в розділі Проблеми розробки компонента у документації на GitHub.

Поділитися через