VisualInteractionSource 類別

定義

命名空間:

Microsoft.UI.Composition.Interactions

物件，用於設定與視覺效果相對的 InteractionTracker 輸入。

VisualInteractionSource 的設計目的是只與 InteractionTracker 搭配使用，並定義哪些輸入會傳送至 InteractionTracker 來驅動其狀態和屬性。 這個類別包含要用於點擊測試的視覺效果，以及各種組態屬性，其中手勢和輸入類型將會傳送至 InteractionTracker。

[WebHostHidden]
public ref class VisualInteractionSource : CompositionObject, ICompositionInteractionSource

/// [Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
/// [Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
/// [Windows.Foundation.Metadata.ContractVersion(Microsoft.Foundation.WindowsAppSDKContract, 65536)]
[WebHostHidden]
class VisualInteractionSource : CompositionObject, ICompositionInteractionSource

[Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
[Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
[Windows.Foundation.Metadata.ContractVersion(typeof(Microsoft.Foundation.WindowsAppSDKContract), 65536)]
public class VisualInteractionSource : CompositionObject, ICompositionInteractionSource

Public Class VisualInteractionSource
Inherits CompositionObject
Implements ICompositionInteractionSource

繼承

Object Platform::Object IInspectable CompositionObject VisualInteractionSource

屬性

ContractVersionAttribute MarshalingBehaviorAttribute ThreadingAttribute

實作

ICompositionInteractionSource

範例

void SetupSimpleInteractionTracker(Visual viewportVisual, Visual contentVisual)
{
  //
  // Create the InteractionTracker and set its min/max position and scale.  These could 
  // also be bound to expressions.  Note: The scrollable area can be changed from either 
  // end to facilitate content updates/virtualization.
  //

  _tracker = InteractionTracker.Create(_compositor);

  _tracker.MaxPosition = new Vector3(
    contentVisual.Size.X - viewportVisual.Size.X,
    contentVisual.Size.Y - viewportVisual.Size.Y,
    0.0f);

  _tracker.MinScale = 0.5f;
  _tracker.MaxScale = 4.0f;


  //
  // Configure the interaction source.  Enable input with inertia on all axis.
  //

  var interactionSource = VisualInteractionSource.Create(viewportVisual);

  interactionSource.PositionXSourceMode = InteractionSourceMode.EnabledWithInertia;
  interactionSource.PositionYSourceMode = InteractionSourceMode.EnabledWithInertia;
  interactionSource.ScaleSourceMode = InteractionSourceMode.EnabledWithInertia;

  _tracker.InteractionSources.Add(interactionSource);


  //
  // Bind the InteractionTracker outputs to the contentVisual.
  //

  var positionExpression = _compositor.CreateExpressionAnimation("-tracker.Position");
  positionExpression.SetReferenceParameter("tracker", _tracker);

  contentVisual.StartAnimation("Offset", positionExpression);


  var scaleExpression = _compositor.CreateExpressionAnimation("Vector3(tracker.Scale, tracker.Scale, 1.0)");

  scaleExpression.SetReferenceParameter("tracker", _tracker);

  contentVisual.StartAnimation("Scale", scaleExpression);
}

備註

VisualInteractionSource 可用來定義應該驅動 InteractionTracker 狀態和屬性之互動類型的重要屬性。 來源屬性用於點擊測試，以及手勢偵測的座標空間。 因此，請務必使用不會在操作期間移動的視覺效果。 如果有多個點擊測試區域，則多個 VisualInteractionSources 可以與相同的 InteractionTracker 相關聯，但最常見的案例只需要一個 VisualInteractionSource 才能用於指定的 InteractionTracker。

VisualInteractionSource 是用來設定應該考慮哪些類型的手勢來驅動 InteractionTracker 的類別。 位置 X 和 Y 分別與水準和垂直移動流覽相關聯。 使用捏合手勢偵測到縮放比例，通常與縮放相關聯。 這三種來源模式全都可以針對觸控和精確度觸控板輸入進行設定。 每個來源模式都可以使用或不使用慣性來啟用：

• 啟用慣性表示位置或縮放比例會在慣性狀態期間自然插入從釋放速度到沒有速度。

• 停用慣性表示完成互動時，位置或縮放速度會立即移至 0。 當驅動位置或小數位數的輸入路由傳送至 InteractionTracker 時，會適當地更新相同名稱的 InteractionTracker 屬性。

滑軌組態會指出如何偵測手勢。 滑軌預設為開啟，表示水準或垂直移動流覽會在主要在該軸上啟動時鎖定至特定座標軸。 這在滑軌屬性頁面上會更詳細地說明。

鏈結組態會指出當 InteractionTracker 到達該方向的最小值或最大值時，某個 VisualInteractionSource 所處理的輸入是否可以流向另一個實體。 此設定允許輸入透過另一個 VisualInteractionSource 鏈結至另一個 InteractionTracker，如果 VisualInteractionSource 的來源視覺效果是 ScrollViewer 的子系，則為 ScrollViewer。

屬性

Comment	要與 CompositionObject 建立關聯的字串。 (繼承來源 CompositionObject)
Compositor	用來建立這個CompositionObject的Compositor。 (繼承來源 CompositionObject)
DeltaPosition	即將推出的框架期間要套用的位置變更量。 預設為 0。 只能透過運算式/動畫讀取。
DeltaScale	即將推出的畫面格期間要套用的縮放比例變更量。 乘法。 預設值為 1。 只能透過運算式/動畫讀取。
DispatcherQueue	取得 CompositionObject 的 DispatcherQueue。 (繼承來源 CompositionObject)
ImplicitAnimations	附加至這個物件的隱含動畫集合。 (繼承來源 CompositionObject)
IsPositionXRailsEnabled	指出 X 軸上的移動流覽是否為滑軌。 IsPositionXRailsEnabled 屬性會定義當 X 軸移動流覽傳送至對應的 InteractionTracker時，的滑軌設定。 啟用時，如果移動流覽的初始部分在相對於 X 軸的特定範圍內角度，則會忽略移動流覽的 Y 元件，並視為完美的水準移動流覽。 這個屬性通常會在啟用 X 和 Y 捲動體驗的情況下啟用，但也需要可靠、完美的水準移動流覽。
IsPositionYRailsEnabled	指出 Y 軸上的移動流覽是否為滑軌。 IsPositionYRailsEnabled 屬性會定義當 Y 軸移動流覽傳送至對應的 InteractionTracker時，的滑軌設定。 啟用時，如果移動流覽的初始部分在相對於 Y 軸的特定範圍內角度，則會忽略移動流覽的 X 元件，並視為完美的垂直移動流覽。 這個屬性通常會在啟用 X 和 Y 捲動體驗的情況下啟用，但也需要可靠、完美的垂直移動流覽。
ManipulationRedirectionMode	指出應該重新導向至 InteractionTracker 的輸入。
PointerWheelConfig	取得指標滾輪輸入的組態。
Position	自互動開始以來，位置總數會變更。 預設為 0。 只能透過運算式/動畫讀取。
PositionVelocity	互動中位置變更的即時速率，每秒以圖元為單位。 預設為 0。 只能透過運算式/動畫讀取。
PositionXChainingMode	PositionXChainingMode 屬性會定義 X 方向的 InteractionSource 鏈結行為。 有三種 InteractionChainingMode 類型： Auto 永遠 永不 啟用 X 方向鏈結時，每當互動 (例如移動流覽) ，輸入就會流向最接近上階的 VisualInteractionSource ，否則 InteractionTracker 的位置會超過其最小值或最大 X 位置。
PositionXSourceMode	X 軸的來源模式。 PositionXSourceMode 屬性會定義如何在 X 軸上處理 VisualInteractionSource 的互動。 有三種 InteractionSourceMode 類型可供選擇： 互動已停用 EnabledWithInertia EnabledWithoutInertia 必須啟用這個屬性，才能讓 VisualInteractionSource 將 X 軸資料傳送至 InteractionTracker。
PositionYChainingMode	PositionYChainingMode 屬性會定義 Y 方向的 InteractionSource 鏈結行為。 InteractionChainingMode s 有三種類型：Auto、Always 、Never 。 啟用 Y 方向鏈結時，每當互動 (例如移動流覽) ，輸入就會流向最接近上階的 VisualInteractionSource ，否則 InteractionTracker 的位置會超過其最小或最大 Y 位置。
PositionYSourceMode	Y 軸的來源模式。 PositionYSourceMode 屬性會定義 Y 軸上 VisualInteractionSource 的互動處理方式。 有三種 InteractionSourceMode 類型可供選擇： 互動已停用 EnabledWithInertia EnabledWithoutInertia 必須啟用這個屬性，才能讓 VisualInteractionSource 將 Y 軸資料傳送至 InteractionTracker。
Properties	與 CompositionObject相關聯的屬性集合。 (繼承來源 CompositionObject)
Scale	自互動開始以來，縮放比例的總百分比差異。 乘法。 預設值為 1。 只能透過運算式/動畫讀取。
ScaleChainingMode	ScaleChainingMode 屬性會定義 Scale 方向的 InteractionSource 鏈結行為。 InteractionChainingMode有三種類型：Auto、Always、Never。 啟用縮放鏈結時，每當互動 (例如移動流覽) ，輸入就會流向最接近上階的 VisualInteractionSource ，否則 會採用 InteractionTracker 超過其最小或最大 Scale 位置的位置。
ScaleSourceMode	定義縮放軸上 VisualInteractionSource 的互動處理方式。 有三種 InteractionSourceMode 類型可供選擇： 停用 EnabledWithInertia EnabledWithoutInertia 必須啟用此屬性， 才能讓 VisualInteractionSource 將縮放資料傳送至 InteractionTracker。
ScaleVelocity	互動中縮放比例的瞬間速率，以每秒百分比為單位。 添加劑。 預設為 0。 只能透過運算式/動畫讀取。
Source	用於點擊測試的視覺效果，並定義手勢辨識的座標空間。

方法

Close()	關閉 CompositionObject 並釋放系統資源。 (繼承來源 CompositionObject)
ConfigureCenterPointXModifiers(IIterable<CompositionConditionalValue>)	取得 CompositionConditionalValue 的已排序清單。 在框架中，第一個 CompositionConditionalValue 具有其 「。[條件] 評估為 true 會取代 VisualInteractionSource 提供其 「」 的縮放 CenterPointX 值。值」。 如果沒有評估為 true，則 CenterPointX 不會取代該框架。
ConfigureCenterPointYModifiers(IIterable<CompositionConditionalValue>)	取得 CompositionConditionalValue 的已排序清單。 在框架中，第一個 CompositionConditionalValue 具有其 「。[條件] 評估為 true 會取代 VisualInteractionSource 提供的縮放 CenterPointY 值及其 「。值」。 如果沒有評估為 true，則 CenterPointY 不會取代該框架。
ConfigureDeltaPositionXModifiers(IIterable<CompositionConditionalValue>)	取得 CompositionConditionalValue 的已排序清單。 在框架中，第一個 CompositionConditionalValue 具有其 「。[條件] 評估為 true 會取代 VisualInteractionSource 提供其 「」 的 DeltaPositionX 值。值」。 如果沒有評估為 true，則 DeltaPositionX 不會取代該框架。
ConfigureDeltaPositionYModifiers(IIterable<CompositionConditionalValue>)	取得 CompositionConditionalValue 的已排序清單。 在框架中，第一個 CompositionConditionalValue 具有其 「。[條件] 評估為 true 會取代 VisualInteractionSource 提供其 「」 的 DeltaPositionY 值。值」。 如果沒有評估為 true，則 DeltaPositionY 不會取代該框架。
ConfigureDeltaScaleModifiers(IIterable<CompositionConditionalValue>)	取得 CompositionConditionalValue 的已排序清單。 在框架中，第一個 CompositionConditionalValue 具有其 「。[條件] 評估為 true 會取代 VisualInteractionSource 提供其 「」 的 DeltaScale 值。值」。 如果沒有評估為 true，則 DeltaScale 不會取代該框架。
Create(Visual)	建立 VisualInteractionSource的實例。
CreateFromIVisualElement(IVisualElement)	從實作IVisualElement的專案建立VisualInteractionSource的實例。
Dispose()	執行與釋放 (Free)、釋放 (Release) 或重設 Unmanaged 資源相關聯之應用程式定義的工作。 (繼承來源 CompositionObject)
PopulatePropertyInfo(String, AnimationPropertyInfo)	定義可以產生動畫效果的屬性。 (繼承來源 CompositionObject)
StartAnimation(String, CompositionAnimation, AnimationController)	使用物件的指定屬性連接動畫，並啟動動畫。 (繼承來源 CompositionObject)
StartAnimation(String, CompositionAnimation)	使用物件的指定屬性連接動畫，並啟動動畫。 (繼承來源 CompositionObject)
StartAnimationGroup(ICompositionAnimationBase)	啟動動畫群組。 CompositionObject上的 StartAnimationGroup 方法可讓您啟動CompositionAnimationGroup。 群組中的所有動畫都會在 物件上同時啟動。 (繼承來源 CompositionObject)
StopAnimation(String)	中斷與指定屬性的動畫連線，並停止動畫。 (繼承來源 CompositionObject)
StopAnimationGroup(ICompositionAnimationBase)	停止動畫群組。 (繼承來源 CompositionObject)
TryGetAnimationController(String)	傳回在指定屬性上執行的動畫的 AnimationController。 (繼承來源 CompositionObject)
TryRedirectForManipulation(PointerPoint)	嘗試從指定的PointerPoint開始，將指定指標資料流程的已設定操作傳送至InteractionTracker，而不是應用程式的 UI 執行緒。 重要 這個方法應該只使用 Touch 的 PointerDeviceType 來呼叫。

另請參閱

• CompositionObject
• ICompositionInteractionSource
• IClosable