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


InputPane Класс

Определение

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

Примечание

API InputPane предоставляют точные сведения о окклюзии только для закрепленной панели. Для Windows 10 Creators Fall Update и более новых версий мы рекомендуем использовать следующие API для обработки окклюзии с помощью закрепленных, отстыкованных, перемещаемых и переходных областей ввода, таких как обратимые панели ввода (SIP), окна-кандидаты редактора метода ввода (IME), плавающие панели инструментов и т. д.

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

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

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

Комментарии

Область ввода появляется, когда пользователь выполняет действие, требующее ввода сведений, таких как выбор текстового поля ввода. По умолчанию Windows обрабатывает события области ввода и перемещает содержимое, чтобы пользователи могли видеть, где они вводят. Если в приложении для CoreTextEditContext.InputPaneDisplayPolicy задано значение Manual , вы несете ответственность за отображение и скрытие области ввода с помощью TryShow и TryHide. Используйте этот класс для переопределения поведения по умолчанию и настройки области ввода.

В некоторых случаях пользовательский интерфейс наложения, например InputPane, поддерживается не полностью. В том числе:

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

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

Примечание

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

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

Версия Windows Версия пакета SDK Добавленная стоимость
1903 18362 GetForUIContext

Свойства

OccludedRect

Возвращает область окна приложения, скрытую областью ввода.

Visible

Возвращает или задает значение, указывающее, отображается ли область ввода.

Важно!

Допустимо только для семейства устройств Xbox.

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

Методы

GetForCurrentView()

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

GetForUIContext(UIContext)

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

TryHide()

Пытается скрыть область ввода, если она видна.

TryShow()

Пытается отобразить область ввода, если она скрыта.

Этот метод является "лучшим" и гарантирует только то, что пользователь может ввести текст в элементе управления с фокусом. Сенсорная клавиатура или панель обратимого ввода (SIP) отображается только в том случае, если аппаратная клавиатура недоступна.

События

Hiding

Происходит, когда область ввода начинает выдвигать из виду.

Showing

Происходит при скольжении области ввода.

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

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