SpriteVisual 類別
定義
重要
部分資訊涉及發行前產品，在發行之前可能會有大幅修改。 Microsoft 對此處提供的資訊，不做任何明確或隱含的瑕疵擔保。
裝載 CompositionBrush類型的 2D Boxed 內容。 筆刷中未由圖元涵蓋的任何視覺效果部分，會轉譯為透明圖元。 CompositionBrush 可以是 CompositionBackdropBrush、CompositionColorBrush、CompositionSurfaceBrush或CompositionEffectBrush。
public ref class SpriteVisual sealed : ContainerVisual/// [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 SpriteVisual final : ContainerVisual[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 SpriteVisual : ContainerVisualPublic NotInheritable Class SpriteVisual
Inherits ContainerVisual- 繼承
- 屬性
Windows 需求
| 裝置系列 |
Windows 10 (已於 10.0.10586.0 引進)
|
| API contract |
Windows.Foundation.UniversalApiContract (已於 v2.0 引進)
|
範例
SpriteVisual visual = compositor.CreateSpriteVisual();
visual.Brush = compositor.CreateColorBrush (Colors.White);
SpriteVisual visual = compositor.CreateSpriteVisual();
var surface = graphicsDevice.CreateDrawingSurface(new Size(300, 50),
Windows.Graphics.DirectX.DirectXPixelFormat.B8G8R8A8UIntNormalized,
CompositionAlphaMode.Ignore);
visual.Brush = compsositor.CreateSurfaceBrush (surface);
新增陰影
//Create surface brush and load in an image
CompositionSurfaceBrush surfaceBrush = compositor.CreateSurfaceBrush();
surfaceBrush.Surface = await imageLoader.LoadImageFromUriAsync(new Uri("ms-appx:///Assets/cat.jpg"));
//Create sprite visual
SpriteVisual visual = compositor.CreateSpriteVisual();
visual.Brush = surfaceBrush;
visual.Size = new Vector2(270, 200);
//Create drop shadow
DropShadow shadow = compositor.CreateDropShadow();
shadow.BlurRadius = 5;
shadow.Offset = new Vector3(15, 15, -10);
shadow.Color = Colors.DarkGray;
//Associate shadow to visual
visual.Shadow = shadow;
備註
版本歷程記錄
| Windows 版本 | SDK 版本 | 已新增值 |
|---|---|---|
| 1607 | 14393 | 陰影 |
屬性
| AnchorPoint |
要放置在視覺效果位移之視覺效果上的點。 值會根據視覺效果的大小正規化。 可產生動畫效果。 (繼承來源 Visual) |
| BackfaceVisibility |
指定在 3D 轉換期間是否應該顯示視覺效果的背面。 (繼承來源 Visual) |
| BorderMode |
指定如何撰寫與視覺效果相關聯之點陣圖和剪輯的邊緣，或與此視覺效果根目錄之子樹中的所有視覺效果。 在父視覺效果上設定 BorderMode 會影響子樹中的所有子系視覺效果，而且可以在每個子視覺效果選擇性地關閉。 (繼承來源 Visual) |
| Brush | |
| CenterPoint |
發生旋轉或縮放的點。 可產生動畫效果 (繼承來源 Visual) |
| Children |
ContainerVisual的子系。 (繼承來源 ContainerVisual) |
| Clip |
指定視覺效果的裁剪區域。 轉譯視覺效果時，只會顯示落在裁剪區域中的視覺效果部分，而任何在裁剪區域外延伸的內容都會裁剪 (，而不是顯示) 。 (繼承來源 Visual) |
| Comment |
要與 CompositionObject 建立關聯的字串。 (繼承來源 CompositionObject) |
| CompositeMode |
指定視覺效果的點陣圖如何與螢幕混合。 (繼承來源 Visual) |
| Compositor |
用來建立這個CompositionObject的Compositor。 (繼承來源 CompositionObject) |
| Dispatcher |
CompositionObject的發送器。 (繼承來源 CompositionObject) |
| DispatcherQueue |
取得 CompostionObject 的 DispatcherQueue 。 (繼承來源 CompositionObject) |
| ImplicitAnimations |
附加至這個物件的隱含動畫集合。 (繼承來源 CompositionObject) |
| IsHitTestVisible |
取得或設定值，這個值表示這個視覺效果上根目錄的視覺子樹狀結構是否參與點擊測試。 (繼承來源 Visual) |
| IsPixelSnappingEnabled |
取得或設定值，這個值表示組合引擎是否對齊呈現的視覺效果與圖元界限。 (繼承來源 Visual) |
| IsVisible |
指出視覺效果及其子視覺效果的整個子樹是否可見。 (繼承來源 Visual) |
| Offset |
視覺效果相對於其父系的位移，或根視覺效果的位移相對於裝載視覺效果之視窗左上角的位移。 可產生動畫效果。 (繼承來源 Visual) |
| Opacity |
視覺效果的不透明度。 可產生動畫效果。 不透明度屬性會判斷視覺效果的任何透明度，而且是介於 0 到 1 之間的值。 0 完全透明，1 不透明。 具有不透明度屬性為 0 的視覺效果仍存在於樹狀結構中。 就像視覺效果上的其他屬性一樣，Opacity 可以使用 Windows、UI 產生動畫效果。組合動畫系統。 (繼承來源 Visual) |
| Orientation |
四元數，描述將在 3D 空間中套用至視覺效果的方向和旋轉。 可產生動畫效果。 (繼承來源 Visual) |
| Parent |
視覺物件的父代。 (繼承來源 Visual) |
| ParentForTransform |
指定這個視覺效果所組成之座標系統的視覺效果。 (繼承來源 Visual) |
| Properties |
與 CompositionObject相關聯的屬性集合。 (繼承來源 CompositionObject) |
| RelativeOffsetAdjustment |
指定視覺效果相對於其父視覺效果大小的位移。 (繼承來源 Visual) |
| RelativeSizeAdjustment |
取得或設定相對於其父視覺效果大小之視覺效果的大小。 (繼承來源 Visual) |
| RotationAngle |
以弧度為單位的視覺效果旋轉角度。 可產生動畫效果。 (繼承來源 Visual) |
| RotationAngleInDegrees |
以度為單位的視覺效果旋轉角度。 可產生動畫效果。 (繼承來源 Visual) |
| RotationAxis |
要繞著旋轉視覺效果的軸。 可產生動畫效果。 (繼承來源 Visual) |
| Scale |
要套用至視覺效果的縮放比例。 (繼承來源 Visual) |
| Shadow |
SpriteVisual的陰影。 |
| Size |
視覺效果的寬度和高度。 可產生動畫效果。 (繼承來源 Visual) |
| TransformMatrix |
要套用至視覺效果的轉換矩陣。 可產生動畫效果。 (繼承來源 Visual) |