共用方式為

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表示。 在此 scenaro 中，主要檢視的高度等於 (Height 1 + Height 2) 。

CoreInputView PrimaryViewAnimationStarting 窗格高度。

CoreInputView PrimaryViewAnimationStarting 持續時間。

接著，PrimaryViewAnimationHiding 事件的 AnimationDuration 會在下圖中以 4 表示，遮蔽高度為 0。

PrimaryViewAnimationHiding 事件的 AnimationDuration 由 #4 表示

注意

浮動輸入窗格遮蔽不需要處理，因此 AnimationDuration 一律為 0。

適用於

另請參閱