CoreFrameworkInputView 类

  • 参考

定义

命名空间:
Windows.UI.ViewManagement.Core
编辑

为 UI 框架提供在相应的 CoreInputViewPrimaryViewAnimationStarting 和 OcclusionsChanged 事件之后处理 PrimaryViewAnimationStarting 和 OcclusionsChanged 事件的能力。

这使框架能够控制停靠、取消停靠、可移动或暂时性输入窗格 (和关联的 UI) 的显示，在移动、显示或隐藏窗格时接收通知，并确定窗格遮挡应用的窗口部分。

注意

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
属性
ContractVersionAttribute MarshalingBehaviorAttribute ThreadingAttribute

Windows 要求

设备系列
Windows 11 (在 10.0.22000.0 中引入)
API contract
Windows.Foundation.UniversalApiContract (在 v14.0 中引入)

注解

仅供框架 (使用，例如 XAML) 或自定义文本控件。

框架可以使用此对象公开的信息来调整和重新排列 UI，以考虑任何遮挡。

CoreFrameworkInputView API 支持以下类型的输入窗格。

  • 停靠的软输入面板 (SIP) （如 触摸键盘和手写面板 ），通常应用 UI 会重排。
  • 浮动工具栏或 SIP – 应用 UI 通常不会重排。
  • 覆盖面板（如内联墨迹或输入法候选窗口）通常，应用 UI 不会重排编辑控件，但会重排文本/搜索建议。

当用户执行要求用户提供信息的操作（例如输入文本字段）时，将显示输入窗格。

默认情况下，Windows 处理输入窗格事件并重新定位内容，以便用户可以看到具有焦点的控件。

调用 CoreFrameworkInputView.GetForCurrentView 以获取 CoreFrameworkInputView 对象。

注册以接收输入窗格通知后，在调用 CoreFrameworkInputView.GetForCurrentView 方法时，每当在前台窗口中显示或隐藏窗格时，系统将调用事件委托。

注意

此类不是敏捷类，这意味着需要考虑其线程模型和封送处理行为。 有关详细信息，请参阅 线程处理和封送处理 (C++/CX) 。

方法

GetForCurrentView()

检索与当前窗口关联的 CoreFrameworkInputView 对象。
GetForUIContext(UIContext)

获取与具有指定上下文标识符的视图关联的 CoreFrameworkInputView 对象。

事件

OcclusionsChanged

当一个或多个 CoreInputViewOcclusion 对象更改其位置或遮挡区域以响应与 CoreFrameworkInputView 关联的输入窗格的重新定位时发生。
PrimaryViewAnimationStarting

应用程序中为响应与 CoreFrameworkInputView 关联的输入窗格的显示或隐藏而发生的动画。

适用于

另请参阅