Ввод и взаимодействие

Приложения WinUI автоматически обрабатывают широкий спектр входных данных и выполняются на различных устройствах— нет ничего дополнительного, чтобы включить сенсорный ввод, например. Но иногда требуется оптимизировать приложение для определенных типов входных данных или устройств. Например, если вы создаете приложение для рисования, может потребоваться настроить способ обработки ввода пера.

Инструкции по проектированию и написанию кода в этом разделе помогут настроить приложение WinUI для определенных типов входных данных.

Использование API ввода среда выполнения Windows в настольных приложениях WinUI 3

Классические настольные приложения WinUI 3 могут напрямую использовать большинство API среда выполнения Windows (WinRT), включая многие API, связанные с вводом, из пространств имён Windows.Devices.Input, Windows.Gaming.Input и Windows.UI.Input. Вам не нужно создавать приложение UWP для доступа к этим возможностям.

Есть несколько вещей, которые следует учитывать:

  • Работает в любом приложении WinUI 3 — свойства указателя (давление, наклон, боковая кнопка пера), определение устройства, доступ к аппаратным возможностям геймпада (Windows.Gaming.Input), а также сенсорный и мышиный ввод — всё это работает без специальной настройки.
  • Требуется удостоверение пакета (MSIX) — некоторые API, такие как SpeechRecognizer и SpeechSynthesizer, требуют наличия удостоверения пакета приложения. Шаблон проекта WinUI 3 по умолчанию использует упаковку MSIX, поэтому это требование выполняется автоматически для большинства приложений.
  • Только для UWP — API, зависящие от ApplicationView, CoreWindow или шаблона GetForCurrentView, недоступны в настольных приложениях. Это включает отслеживание взгляда (GazeInputSourcePreview) и инъекцию ввода (InputInjector). Для этих функций справочная документация по UWP остается лучшим ресурсом.

Полный список поддерживаемых и неподдерживаемых API WinRT в классических приложениях см. в среда выполнения Windows API, поддерживаемых в классических приложениях.

Подсказка

Разделы этого раздела, ссылающиеся на документацию по UWP, охватывают функции, использующие API только для UWP. Вы по-прежнему можете обращаться к этим разделам за рекомендациями по проектированию и сведениями об основных концепциях, хотя API-интерфейсы недоступны напрямую в настольных приложениях WinUI 3.

Get started

Тема Описание
Праймер для входа Ознакомьтесь с каждым типом входного устройства и его поведением, возможностями и ограничениями при паре с определенными форм-факторами.
Вход с помощью взгляда Отслеживайте взгляд пользователя на основе расположения и перемещения глаз и головы. Для API управления взглядом требуется UWP; см. соответствующую справочную статью UWP.

Устройства ввода

Тема Описание
Определение устройств ввода Определите устройства ввода, подключенные к устройству приложения Windows, и определите их возможности и атрибуты.
Указатель Получать, обрабатывать и управлять входными данными, поступающими с указательных устройств, таких как сенсорный экран, мышь, перо/стилус и сенсорная панель.
Перо и Windows Ink Обрабатывайте свойства ввода, характерные для стилуса, такие как давление, наклон, боковая кнопка и обнаружение ластика.
Touch Обрабатывайте сенсорный ввод, обеспечивая иммерсивные возможности, которые ваши пользователи смогут уверенно исследовать.
Мышь Обработка ввода мыши в приложении, включая нажатия кнопки, колесико прокрутки и перемещение указателя.
Клавиатура Обрабатывайте ввод с клавиатуры — важнейшую часть пользовательского взаимодействия и неотъемлемое условие доступности.
Геймпад и удаленный контроль Проектирование с учетом ввода с геймпада Xbox и пульта дистанционного управления. API Windows.Gaming.Input работают непосредственно в настольных приложениях WinUI 3; в связанном разделе UWP рассматриваются шаблоны проектирования для 10-футового интерфейса.
Сенсорный панель Обрабатывайте ввод с тачпада, который сочетает косвенный мультисенсорный ввод с точностью координатного устройства.
Несколько входных данных Проектируйте приложение так, чтобы оно поддерживало как можно больше типов ввода, обеспечивая максимальную гибкость, удобство использования и доступность.
Настраиваемые текстовые входные данные Используйте основные API текста для получения текстовых данных от любой службы текста, поддерживаемой на Windows устройствах, на любом языке и из любого типа ввода.

Взаимодействия

Тема Описание
Перетащите и отпустите Включите функцию перетаскивания в вашем приложении.
Panning Рекомендации по реализации взаимодействий панорамирования.
Вращение Рекомендации по реализации взаимодействий вращения.
Выделение текста и изображений Рекомендации по выбору и управлению текстом, изображениями и элементами управления.
Целеуказание Рекомендации по использованию сенсорного нацеливания и визуальной обратной связи.
Визуальный отзыв Предоставление визуальной обратной связи пользователям во время взаимодействия.
Оптическое масштабирование и изменение размера Рекомендации по масштабированию и изменении размера элементов.

Речь и обратная связь

Тема Описание
Речь Интеграция распознавания речи и преобразования текста в речь непосредственно в взаимодействие с пользователем приложения. Требуется идентификатор пакета.
Haptics Добавьте тактильную отдачу, чтобы подтверждать действия пользователя и сделать взаимодействие более отзывчивым и интуитивно понятным.
  • Last updated on