CoreInputView Класс

Определение

Пространство имен:

Windows.UI.ViewManagement.Core

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

Примечание

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

public ref class CoreInputView sealed

/// [Windows.Foundation.Metadata.ContractVersion(Windows.Foundation.UniversalApiContract, 327680)]
/// [Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
/// [Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
class CoreInputView final

[Windows.Foundation.Metadata.ContractVersion(typeof(Windows.Foundation.UniversalApiContract), 327680)]
[Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
[Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
public sealed class CoreInputView

Public NotInheritable Class CoreInputView

Наследование

Object Platform::Object IInspectable CoreInputView

Атрибуты

ContractVersionAttribute MarshalingBehaviorAttribute ThreadingAttribute

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

Семейство устройств	Windows 10 Fall Creators Update (появилось в 10.0.16299.0)
API contract	Windows.Foundation.UniversalApiContract (появилось в v5.0)

Комментарии

Основное представление относится к любому из представлений CoreInputViewKind.Keyboard или CoreInputViewKind.Handwriting , тогда как CoreInputView может быть любым из значений Из CoreInputViewKind.Handwriting.

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

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

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

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

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

По умолчанию Windows обрабатывает события области ввода и перемещает содержимое, чтобы пользователи могли видеть элемент управления с фокусом. Если в приложении для CoreTextEditContext.InputPaneDisplayPolicy задано значение Вручную , вы несете ответственность за отображение и скрытие области ввода с помощью TryShowPrimaryView и TryHidePrimaryView. Используйте этот класс для переопределения поведения по умолчанию и настройки области ввода.

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

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

Примечание

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

Журнал версий

Версия Windows	Версия пакета SDK	Добавленная стоимость
1803	17134	TryTransferXYFocusToPrimaryView
1803	17134	XYFocusTransferredToPrimaryView
1803	17134	XYFocusTransferringFromPrimaryView
1809	17763	TryHide
1809	17763	TryShow
1809	17763	TryShow(CoreInputViewKind)
1903	18362	GetForUIContext
2004	19041	PrimaryViewHiding
2004	19041	PrimaryViewShowing

Методы

GetCoreInputViewOcclusions()	Извлекает ссылку на каждую область ввода, в настоящее время включающую приложение.
GetForCurrentView()	Извлекает объект CoreInputView, связанный с текущим окном.
GetForUIContext(UIContext)	Возвращает объект CoreInputView, связанный с представлением, имеющим указанный идентификатор контекста.
IsKindSupported(CoreInputViewKind)	Возвращает значение, указывающее, поддерживается ли указанный тип CoreInputView .
TryHide()	Пытается скрыть (если отображается) область ввода, связанную с областью CoreInputView .
TryHidePrimaryView()	Пытается скрыть (если отображается) область ввода, связанную с CoreInputView.
TryShow()	Пытается отобразить (если она скрыта) область ввода, связанную с CoreInputView.
TryShow(CoreInputViewKind)	Пытается показать (если он скрыт) область ввода указанного типа , связанную с CoreInputView.
TryShowPrimaryView()	Пытается отобразить панель CoreInputView (если она скрыта). Этот метод является "лучшим" и гарантирует только то, что у пользователя есть способ взаимодействия с элементом управления. Для закрепленной панели обратимого ввода (SIP), такой как сенсорная клавиатура и панель рукописного ввода, эта панель отображается только в том случае, если аппаратная клавиатура недоступна.
TryTransferXYFocusToPrimaryView(Rect, CoreInputViewXYFocusTransferDirection)	Пытается переместить фокус из пользовательского интерфейса приложения в область ввода.

События

OcclusionsChanged	Происходит, когда один или несколько объектов CoreInputViewOcclusion изменяют свое положение или область окклюзии в ответ на изменение положения области ввода, связанной с CoreInputView.
PrimaryViewAnimationStarting	Анимации в приложении, возникающие в ответ на отображение или скрытие основного представления CoreInputView .
PrimaryViewHiding	Происходит перед скрытием области ввода, связанной с CoreInputView (если она видна).
PrimaryViewShowing	Происходит до отображения области ввода, связанной с CoreInputView (если она скрыта).
SupportedKindsChanged	Происходит при изменении коллекции поддерживаемых представлений CoreInputViewKind для CoreInputView .
XYFocusTransferredToPrimaryView	Происходит при перемещении фокуса в область ввода из пользовательского интерфейса приложения.
XYFocusTransferringFromPrimaryView	Происходит до того, как область ввода потеряет фокус и до того, как элемент пользовательского интерфейса получит фокус.

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

• CoreFrameworkInputView