Microsoft.UI.Composition.Interactions 命名空間
重要
部分資訊涉及發行前產品,在發行之前可能會有大幅修改。 Microsoft 對此處提供的資訊,不做任何明確或隱含的瑕疵擔保。
提供可在視覺層中啟用輸入驅動動畫的功能。
類別
| 名稱 | Description |
|---|---|
| CompositionConditionalValue |
允許有條件地修改視覺互動源的位置與尺度。 |
| CompositionInteractionSourceCollection |
一系列互動來源。 這是與特定 互動追蹤器相關聯的互動來源集合。 這個集合中唯一有效的成員是 VisualInteractionSource。 每個 VisualInteractionSource 都需要有一個獨特的 hit-test(source)視覺化。 每個 VisualInteractionSource 都會被個別設定,以便將所需的輸入傳送到 InteractionTracker。 |
| InteractionSourceConfiguration |
代表 VisualInteractionSource 輸入的配置。 |
| InteractionTracker |
處理可作為 ExpressionAnimations 目標的輸入邏輯——通常用來驅動視覺動作,根據輸入。 |
| InteractionTrackerCustomAnimationStateEnteredArgs |
關於 IInteractionTrackerOwner.CustomAnimationStateEntered 的論據。 |
| InteractionTrackerIdleStateEnteredArgs | |
| 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 | |
| InteractionTrackerRequestIgnoredArgs |
關於 IInteractionTrackerOwner.RequestMiss 回撥的論點。 |
| InteractionTrackerValuesChangedArgs | |
| InteractionTrackerVector2InertiaModifier | |
| InteractionTrackerVector2InertiaNaturalMotion |
一個 Vector2NaturalMotionAnimation ,定義 InteractionTracker 在慣性狀態下的運動。 |
| VisualInteractionSource |
用於設定 InteractionTracker 輸入相對於視覺化的物件。 VisualInteractionSource 設計僅供 InteractionTracker 使用,並定義將送入 InteractionTracker 以驅動其狀態與屬性的輸入。 此類別包含用於命中測試的視覺化,以及多種配置屬性,這些屬性將手勢與輸入類型傳送至 InteractionTracker。 |
介面
| 名稱 | Description |
|---|---|
| ICompositionInteractionSource |
一個在合成器中被追蹤互動的物件。 |
| IInteractionTrackerOwner |
包含由 InteractionTracker 事件觸發的回調。 實作此介面後,能接收有關 InteractionTracker 狀態與值的回調,以及是否尊重 InteractionTracker 屬性的更新。 |
列舉
| 名稱 | Description |
|---|---|
| InteractionBindingAxisModes |
定義了指定兩個交互追蹤器之間綁定軸的常數。 |
| InteractionChainingMode |
定義 VisualInteractionSource 的連鎖行為。 有三種選擇:永遠連鎖、永不連鎖或自動連鎖(讓系統自行決定)。 若啟用鏈結,當 互動追蹤 器達到最小或最大界限時,會將輸入傳送至下一個祖先 VisualInteractionSource。 |
| InteractionSourceMode |
提供 VisualInteractionSource 如何處理互動的各種定義。 列舉可用的選項有 Disabled、 EnabledWithInertia 和 EnabledWithoutInertia。 InteractionSourceMode 可用來定義 VisualInteractionSource 的 X、Y 與縮放軸的行為。 |
| InteractionSourceRedirectionMode |
定義常數,指定輸入是否應被導向至 InteractionTracker。 |
| InteractionTrackerClampingOption |
定義了當 InteractionTracker 位置更新時,值如何被夾持的常數。 |
| InteractionTrackerPositionUpdateOption |
定義常數,指示已執行的自訂縮放動畫是否應該繼續執行。 |
| VisualInteractionSourceRedirectionMode |
指示哪些輸入應該被重新導向到 InteractionTracker。 |