CoreInputView.PrimaryViewAnimationStarting 事件

定义

命名空间:

Windows.UI.ViewManagement.Core

应用程序中为响应 CoreInputView 主视图的显示或隐藏而发生的动画。

// Register
event_token PrimaryViewAnimationStarting(TypedEventHandler<CoreInputView, CoreInputViewAnimationStartingEventArgs const&> const& handler) const;

// Revoke with event_token
void PrimaryViewAnimationStarting(event_token const* cookie) const;

// Revoke with event_revoker
CoreInputView::PrimaryViewAnimationStarting_revoker PrimaryViewAnimationStarting(auto_revoke_t, TypedEventHandler<CoreInputView, CoreInputViewAnimationStartingEventArgs const&> const& handler) const;

public event TypedEventHandler<CoreInputView,CoreInputViewAnimationStartingEventArgs> PrimaryViewAnimationStarting;

function onPrimaryViewAnimationStarting(eventArgs) { /* Your code */ }
coreInputView.addEventListener("primaryviewanimationstarting", onPrimaryViewAnimationStarting);
coreInputView.removeEventListener("primaryviewanimationstarting", onPrimaryViewAnimationStarting);
- or -
coreInputView.onprimaryviewanimationstarting = onPrimaryViewAnimationStarting;

Public Custom Event PrimaryViewAnimationStarting As TypedEventHandler(Of CoreInputView, CoreInputViewAnimationStartingEventArgs) 

事件类型

TypedEventHandler<CoreInputView,CoreInputViewAnimationStartingEventArgs>

Windows 要求

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

注解

主视图是指 CoreInputViewKind.Keyboard 或 CoreInputViewKind.Handwriting 视图之一，而 CoreInputView 可以是 CoreInputViewKind 中的任何值。

重要

在设置基于显示或隐藏 CoreInputView 的任何动画持续时间时，应用程序应使用此值。 如果协调应用程序和 CoreInputView 之间的动画，请确保应用程序动画在 CoreInputView 动画之前未完成，以避免在应用程序内容和输入窗格之间的空间中看到任何不一致的背景视觉对象。

应用程序 UI 基于 CoreInputViewOcclusion.OccludingRect 重排，隐藏时它是空的 rect。

输入窗格在开始时更快地对屏幕进行动画处理，同时逐渐减慢到末尾， (在屏幕) 对屏幕进行动画处理时发生完全相反的情况。

如果当前应用窗口的位置如下图所示 (1 指示) 底部边缘的高度，则 PrimaryViewAnimationStarting 事件的 CoreInputViewOcclusion 的高度由 2 指示，AnimationDuration 由 3 指示。 在此场景下，主视图的高度等于 (高度 1 + 高度 2) 。

在下图中，PrimaryViewAnimationHiding 事件的 AnimationDuration 由 4 指示，遮挡高度为 0。

注意

无需处理浮动输入窗格遮挡，因此 AnimationDuration 始终为 0。

另请参阅

• CoreInputViewAnimationStartingEventArgs
• TryShow()
• TryShow(CoreInputViewKind)
• TryHide()