CompositionSurfaceBrush 類別

定義

命名空間:

Windows.UI.Composition

使用 ICompositionSurface 中的圖元繪製 SpriteVisual 。

public ref class CompositionSurfaceBrush sealed : CompositionBrush

/// [Windows.Foundation.Metadata.ContractVersion(Windows.Foundation.UniversalApiContract, 131072)]
/// [Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
/// [Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
class CompositionSurfaceBrush final : CompositionBrush

[Windows.Foundation.Metadata.ContractVersion(typeof(Windows.Foundation.UniversalApiContract), 131072)]
[Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
[Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
public sealed class CompositionSurfaceBrush : CompositionBrush

Public NotInheritable Class CompositionSurfaceBrush
Inherits CompositionBrush

繼承

Object Platform::Object IInspectable CompositionObject CompositionBrush CompositionSurfaceBrush

屬性

ContractVersionAttribute MarshalingBehaviorAttribute ThreadingAttribute

Windows 需求

裝置系列	Windows 10 (已於 10.0.10586.0 引進)
API contract	Windows.Foundation.UniversalApiContract (已於 v2.0 引進)

範例

將影像資產繪製到 SpriteVisual

private SpriteVisual CreateImageVisual(ICompositionSurface imageSurface)
{
  SpriteVisual imageVisual = _compositor.CreateSpriteVisual();
  imageVisual.Size = new Vector2(300, 200);

  CompositionSurfaceBrush imageBrush = _compositor.CreateSurfaceBrush();
  imageBrush.Surface = imageSurface;

  // specify CompositionStretch on SurfaceBrush and horizontal/vertical alignment
  imageBrush.Stretch = CompositionStretch.UniformToFill;
  imageBrush.HorizontalAlignmentRatio = 0.5f;
  imageBrush.VerticalAlignmentRatio = 0.5f;

  imageVisual.Brush = imageBrush;
  return imageVisual;
}

將自訂縮放轉換動畫套用至 CompositionSurfaceBrush

private void AnimateBrushScale(SpriteVisual imageVisual)
{
  CompositionSurfaceBrush imageBrush = (CompositionSurfaceBrush)imageVisual.Brush;

  // set brush CenterPoint at the center of the content painted onto imageVisual 
  imageBrush.CenterPoint = imageVisual.Size / 2;

  // set up scale keyframe animation
  CompositionScopedBatch batch = _compositor.CreateScopedBatch(CompositionBatchTypes.Animation);
  Vector2KeyFrameAnimation scaleAnimation = _compositor.CreateVector2KeyFrameAnimation();
  scaleAnimation.InsertKeyFrame(1.0f, new Vector2(1.5f));
  scaleAnimation.Duration = TimeSpan.FromMilliseconds(500);

  // start animation on CompositionSurfaceBrush.Scale
  imageBrush.StartAnimation("Scale", scaleAnimation);

  // end animation batch and fire completion event
  batch.End();
  batch.Completed += ScaleAnimationBatch_Completed;
} 

備註

Stretch 屬性與 HorizontalAlignmentRatio 和 VerticalAlignmentRatio 屬性搭配使用，可用來指定在繪製到 SpriteVisual 時 CompositionSurfaceBrush 內容的縮放比例和位置。

CompositionSurfaceBrush 也有下列屬性，可啟用自訂轉換：

• AnchorPoint
• CenterPoint
• Offset
• RotationAngle
• RotationAngleInDegrees
• 調整
• TransformMatrix

CompositionSurfaceBrush 上的轉換作業順序如下：

1. CompositionSurfaceBrush 的內容會延展並對齊 SpriteVisual (請參閱 Stretch、 HorizontalAlignmentRatio和 VerticalAlignmentRatio 屬性) 。

2. 會套用 CompositionSurfaceBrush 上設定的任何其他轉換屬性。

   因此，套用至 CompositionSurfaceBrush 的自訂轉換會在筆刷繪製所在的 SpriteVisual 座標空間中進行評估。 例如，設定 Vector2 的位移 (100，0) 會將筆刷的延展和對齊內容位移 100 個單位，相對於其繪製到 SpriteVisual 的左邊緣。。

版本歷程記錄

Windows 版本	SDK 版本	已新增值
1607	14393	AnchorPoint
1607	14393	CenterPoint
1607	14393	Offset
1607	14393	RotationAngle
1607	14393	RotationAngleInDegrees
1607	14393	調整
1607	14393	TransformMatrix
1903	18362	SnapToPixels

屬性

AnchorPoint	筆刷上要放置在筆刷位移上的點。 值會根據 SpriteVisual 的大小正規化。
BitmapInterpolationMode	指定當 ICompositionSurface 的圖元未形成一對一對應至 SpriteVisual (上的圖元時，用於插補來自 ICompositionSurface 的演算法，如同在延展、縮放、旋轉和其他轉換下可能發生) 。
CenterPoint	筆刷旋轉和縮放的點。
Comment	要與 CompositionObject 建立關聯的字串。 (繼承來源 CompositionObject)
Compositor	用來建立這個CompositionObject的Compositor。 (繼承來源 CompositionObject)
Dispatcher	CompositionObject的發送器。 (繼承來源 CompositionObject)
DispatcherQueue	取得 CompostionObject 的 DispatcherQueue 。 (繼承來源 CompositionObject)
HorizontalAlignmentRatio	控制與 SpriteVisual垂直軸相關的內容垂直軸位置。 此值會從 0.0f 限制為 1.0f，其中 0.0f 代表左垂直邊緣，而 1.0f 則代表 SpriteVisual的右垂直邊緣。
ImplicitAnimations	附加至這個物件的隱含動畫集合。 (繼承來源 CompositionObject)
Offset	筆刷相對於其 SpriteVisual的位移。
Properties	與 CompositionObject相關聯的屬性集合。 (繼承來源 CompositionObject)
RotationAngle	筆刷的旋轉角度，以弧度為單位。
RotationAngleInDegrees	筆刷的旋轉角度，以度為單位。
Scale	要套用至筆刷的尺規。
SnapToPixels	取得或設定值，這個值表示表面筆刷是否與圖元對齊。
Stretch	控制套用至 ICompositionSurface 內容相對於所繪製之 SpriteVisual 大小的縮放比例。
Surface	與CompositionSurfaceBrush相關聯的ICompositionSurface。
TransformMatrix	要套用至筆刷的轉換矩陣。
VerticalAlignmentRatio	控制與 SpriteVisual水準軸相關的內容水準軸位置。 此值會從 0.0f 固定到 1.0f，其中 0.0f 代表上層水準邊緣，而 1.0f 則代表 SpriteVisual的底部水準邊緣。 預設值為 0.5f。

方法

Close()	關閉 CompositionObject 並釋放系統資源。 (繼承來源 CompositionObject)
ConnectAnimation(String, CompositionAnimation)	連接和動畫。 (繼承來源 CompositionObject)
DisconnectAnimation(String)	中斷動畫的連接。 (繼承來源 CompositionObject)
Dispose()	執行與釋放 (Free)、釋放 (Release) 或重設 Unmanaged 資源相關聯之應用程式定義的工作。 (繼承來源 CompositionObject)
PopulatePropertyInfo(String, AnimationPropertyInfo)	定義可以產生動畫效果的屬性。 (繼承來源 CompositionObject)
StartAnimation(String, CompositionAnimation)	使用物件的指定屬性連接動畫，並啟動動畫。 (繼承來源 CompositionObject)
StartAnimation(String, CompositionAnimation, AnimationController)	使用物件的指定屬性連接動畫，並啟動動畫。 (繼承來源 CompositionObject)
StartAnimationGroup(ICompositionAnimationBase)	啟動動畫群組。 CompositionObject上的 StartAnimationGroup 方法可讓您啟動CompositionAnimationGroup。 群組中的所有動畫都會在 物件上同時啟動。 (繼承來源 CompositionObject)
StopAnimation(String)	中斷與指定屬性的動畫連線，並停止動畫。 (繼承來源 CompositionObject)
StopAnimationGroup(ICompositionAnimationBase)	停止動畫群組。 (繼承來源 CompositionObject)
TryGetAnimationController(String)	傳回在指定屬性上執行的動畫的 AnimationController。 (繼承來源 CompositionObject)

另請參閱

• CompositionBrush
• IClosable