Microsoft.UI.Composition.Interactions 命名空間

提供可在視覺層中啟用輸入驅動動畫的功能。

類別

名稱 Description
CompositionConditionalValue

允許有條件地修改視覺互動源的位置與尺度。

CompositionInteractionSourceCollection

一系列互動來源。

這是與特定 互動追蹤器相關聯的互動來源集合。 這個集合中唯一有效的成員是 VisualInteractionSource。 每個 VisualInteractionSource 都需要有一個獨特的 hit-test(source)視覺化。 每個 VisualInteractionSource 都會被個別設定,以便將所需的輸入傳送到 InteractionTracker

InteractionSourceConfiguration

代表 VisualInteractionSource 輸入的配置。

InteractionTracker

處理可作為 ExpressionAnimations 目標的輸入邏輯——通常用來驅動視覺動作,根據輸入。

InteractionTrackerCustomAnimationStateEnteredArgs

關於 IInteractionTrackerOwner.CustomAnimationStateEntered 的論據。

InteractionTrackerIdleStateEnteredArgs

支持 IInteractionTrackerOwner.IdleStateEntered 的回電論點。

InteractionTrackerInertiaModifier

慣性修正的基礎類別。

InteractionTrackerInertiaModifier 代表慣性修飾器的基底類別。 慣性修飾符可視為改變 InteractionTracker 最終靜止位置與方式行為的方法。 改變 InteractionTracker 的這種行為常用於需要更多自訂動作體驗,例如吸附點。 你可以用慣性修飾符修改 InteractionTracker 的行為有兩種變化:在與 InteractionTrackerInertiaRestingValue 類別互動後,修改其最終靜止位置,或用 InteractionTrackerInertiaMotion 類別定義計算慣性期間實際動作與最終靜止位置的方程式。 這些修飾符會應用於 X 位置、Y 位置或互動 追蹤器的縮放。

InteractionTrackerInertiaMotion

一個定義 InteractionTracker 在慣性狀態下的運動的 ExpressionAnimation

InteractionTrackerMotion 類別包含兩個 ExpressionAnimations,代表 InteractionTracker 用來定義從慣性開始到結束的二階導數方程,當特定條件達成時。 InteractionTrackerMotion 類別被定義為兩部分:定義動作何時發生的條件陳述,以及描述 InteractionTracker 如何達到最終靜止位置的方程式。 當你需要定義一個自訂的動作(例如彈簧動作)讓 InteractionTracker 在慣性狀態下使用時,可以使用 InteractionTrackerInertiaMotion 類別。

InteractionTrackerInertiaNaturalMotion

一個定義 InteractionTracker 在慣性狀態下的運動的 純量自然動畫

InteractionTrackerInertiaRestingValue

一個 ExpressionAnimation ,定義互動後的靜止位置。

InteractionTrackerInertiaRestingValue 類別定義了兩個 ExpressionAnimations,當特定條件達成時,計算 InteractionTracker 的明確靜止位置。 InteractionTrackerInertiaRestingValue 定義為兩部分:條件陳述句,若為真,則需明確定義 InteractionTracker 的特定休息位置;以及描述數學關係的方程式,用以輸出該位置。 當需要確保互動追蹤器在互動發生後會落在特定位置時,請使用 InteractionTrackerInertiaRestingValue 類別。

InteractionTrackerInertiaStateEnteredArgs

支持 IInteractionTrackerOwner.InertiaStateEntered 的回撥。

InteractionTrackerOwner.InertiaStateEntered 類別定義了當 InteractionTracker 進入慣性狀態時,可存取的屬性值和 up-to-日期的屬性值。 若註冊於 InertiaStateEntered 事件,該物件屬性的值代表系統在慣性狀態開始時計算的結果。 使用經過調整且自然的休息姿勢,有助於實現像是捲動虛擬化等情境。

InteractionTrackerInteractingStateEnteredArgs

關於 IInteractionTrackerOwner.InteractingStateEntered 回撥的論點。

InteractionTrackerRequestIgnoredArgs

關於 IInteractionTrackerOwner.RequestMiss 回撥的論點。

InteractionTrackerValuesChangedArgs

IInteractionTrackerOwner.ValuesChanged 回調的論點。

InteractionTrackerVector2InertiaModifier

InteractionTrackerVector2InertiaNaturalMotion 的基底類別。

InteractionTrackerVector2InertiaNaturalMotion

一個 Vector2NaturalMotionAnimation ,定義 InteractionTracker 在慣性狀態下的運動。

VisualInteractionSource

用於設定 InteractionTracker 輸入相對於視覺化的物件。

VisualInteractionSource 設計僅供 InteractionTracker 使用,並定義將送入 InteractionTracker 以驅動其狀態與屬性的輸入。 此類別包含用於命中測試的視覺化,以及多種配置屬性,這些屬性將手勢與輸入類型傳送至 InteractionTracker

介面

名稱 Description
ICompositionInteractionSource

一個在合成器中被追蹤互動的物件。

IInteractionTrackerOwner

包含由 InteractionTracker 事件觸發的回調。

實作此介面後,能接收有關 InteractionTracker 狀態與值的回調,以及是否尊重 InteractionTracker 屬性的更新。

列舉

名稱 Description
InteractionBindingAxisModes

定義了指定兩個交互追蹤器之間綁定軸的常數。

InteractionChainingMode

定義 VisualInteractionSource 的連鎖行為。 有三種選擇:永遠連鎖、永不連鎖或自動連鎖(讓系統自行決定)。 若啟用鏈結,當 互動追蹤 器達到最小或最大界限時,會將輸入傳送至下一個祖先 VisualInteractionSource

InteractionSourceMode

提供 VisualInteractionSource 如何處理互動的各種定義。 列舉可用的選項有 DisabledEnabledWithInertiaEnabledWithoutInertia。 InteractionSourceMode 可用來定義 VisualInteractionSource 的 X、Y 與縮放軸的行為。

InteractionSourceRedirectionMode

定義常數,指定輸入是否應被導向至 InteractionTracker。

InteractionTrackerClampingOption

定義了當 InteractionTracker 位置更新時,值如何被夾持的常數。

InteractionTrackerPositionUpdateOption

定義常數,指示已執行的自訂縮放動畫是否應該繼續執行。

VisualInteractionSourceRedirectionMode

指示哪些輸入應該被重新導向到 InteractionTracker。