通过

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 不会重排。
  • 覆盖面板（例如内联墨迹或 IME 候选窗口）-通常，应用 UI 不会为编辑控件重排，而是为文本/搜索建议重排。

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

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

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

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

注意

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

方法

GetForCurrentView()

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

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

事件

OcclusionsChanged

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

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

适用于

另请参阅