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


CoreFrameworkInputView Класс

Определение

Предоставляет платформы пользовательского интерфейса с возможностью обрабатывать события PrimaryViewAnimationStarting и события OcclusionsChanged после соответствующих событий CoreInputViewPrimaryViewAnimationStarting и событий OcclusionsChanged.

Это позволяет платформе управлять отображением закрепленной, открещенной, перемещенной или транзитной области ввода (и связанного пользовательского интерфейса), получать уведомления при перемещении, отображении или скрытии панели, а также определять, какая часть окна приложения скрыта панелью.

Заметка

Не поддерживается в HoloLens.

public ref class CoreFrameworkInputView sealed
/// [Windows.Foundation.Metadata.ContractVersion(Windows.Foundation.UniversalApiContract, 851968)]
/// [Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
/// [Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
class CoreFrameworkInputView final
[Windows.Foundation.Metadata.ContractVersion(typeof(Windows.Foundation.UniversalApiContract), 851968)]
[Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
[Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
public sealed class CoreFrameworkInputView
Public NotInheritable Class CoreFrameworkInputView
Наследование
Object Platform::Object IInspectable CoreFrameworkInputView
Атрибуты

Требования к Windows

Семейство устройств
Windows 11 (появилось в 10.0.22000.0)
API contract
Windows.Foundation.UniversalApiContract (появилось в v14.0)

Комментарии

Используется только платформами (например, XAML) или пользовательскими текстовыми элементами управления.

Платформа может использовать сведения, предоставляемые этим объектом, для настройки и повторного потока пользовательского интерфейса для учета любой окклюзии.

API CoreFrameworkInputView поддерживают следующие типы панелей ввода.

  • Закрепленная панель обратимого ввода (SIP), например клавиатура сенсорной клавиатуры и панель рукописного ввода, как правило, перетекает пользовательский интерфейс приложения.
  • Плавающая панель инструментов или SIP, как правило, пользовательский интерфейс приложения не переполняет.
  • Панели наложения, такие как встроенные окна рукописного ввода или кандидатов IME, как правило, пользовательский интерфейс приложения не переполняется для элемента управления редактирования, но выполняет повторное выполнение предложений по тексту или поиску.

Область ввода отображается, когда пользователь выполняет действие, которое требует от них предоставления информации, например ввода текстового поля.

По умолчанию Windows обрабатывает события области ввода и перемещает содержимое, чтобы пользователи могли видеть элемент управления с фокусом.

Вызовите CoreFrameworkInputView.GetForCurrentView, чтобы получить объект CoreFrameworkInputView.

После регистрации для получения уведомлений области ввода система вызывает делегат события всякий раз, когда панель отображается или скрыта для окна переднего плана при вызове метода CoreFrameworkInputView.GetForCurrentView.

Заметка

Этот класс не является гибким, что означает, что необходимо рассмотреть свою модель потоков и поведение маршалинга. Дополнительные сведения см. впотоковой и маршалинг (C++/CX).

Методы

GetForCurrentView()

Извлекает объект CoreFrameworkInputView, связанный с текущим окном.

GetForUIContext(UIContext)

Возвращает объект CoreFrameworkInputView, связанный с представлением с указанным идентификатором контекста.

События

OcclusionsChanged

Происходит, когда один или несколько объектов CoreInputViewOcclusion изменяют их положение или область occluding в ответ на изменение положения области ввода, связанной с CoreFrameworkInputView.

PrimaryViewAnimationStarting

Анимации в приложении, которое происходит в ответ на отображение или скрытие области ввода, связанной с CoreFrameworkInputView.

Применяется к

См. также раздел