SpriteVisual Kelas

Referensi

Definisi

Ruang nama:: Windows.UI.Composition

Penting

Beberapa informasi terkait produk prarilis yang dapat diubah secara signifikan sebelum dirilis. Microsoft tidak memberikan jaminan, tersirat maupun tersurat, sehubungan dengan informasi yang diberikan di sini.

Edit

Host konten kotak 2D jenis KomposisiBrush. Bagian mana pun dari visual yang tidak dicakup oleh piksel dari kuas dirender sebagai piksel transparan. KomposisiBrush dapat berupa KomposisiBackdropBrush, KomposisiColorBrush, KomposisiSurfaceBrush atau KomposisiEffectBrush.

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 : ContainerVisual

Public NotInheritable Class SpriteVisual
Inherits ContainerVisual

Warisan: Object Platform::Object IInspectable CompositionObject Visual ContainerVisual SpriteVisual

Atribut: ContractVersionAttribute MarshalingBehaviorAttribute ThreadingAttribute

Persyaratan Windows

Rangkaian perangkat	Windows 10 (diperkenalkan dalam 10.0.10586.0)
API contract	Windows.Foundation.UniversalApiContract (diperkenalkan dalam v2.0)

Contoh

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);

Menambahkan Bayangan

//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;

Keterangan

Riwayat versi

Versi Windows	Versi SDK	Nilai ditambahkan
1607	14393	Bayangan

Properti

AnchorPoint	Titik pada visual yang akan diposisikan pada offset visual. Nilai dinormalisasi sehubungan dengan ukuran visual. Bisa dianimasikan. (Diperoleh dari Visual)
BackfaceVisibility	Menentukan apakah wajah belakang visual harus terlihat selama transformasi 3D. (Diperoleh dari Visual)
BorderMode	Menentukan cara menyusun tepi bitmap dan klip yang terkait dengan visual, atau dengan semua visual dalam subtree yang berakar pada visual ini. Mengatur BorderMode pada Visual induk akan memengaruhi semua visual turunan dalam subtree dan dapat dinonaktifkan secara selektif pada setiap visual anak. (Diperoleh dari Visual)
Brush	KomposisiBrush yang menjelaskan bagaimana SpriteVisual dicat.
CenterPoint	Titik tentang rotasi atau penskalaan mana yang terjadi. Dapat dianimasikan (Diperoleh dari Visual)
Children	Turunan dari ContainerVisual. (Diperoleh dari ContainerVisual)
Clip	Menentukan wilayah kliping untuk visual. Saat visual dirender, hanya bagian visual yang berada di dalam wilayah kliping yang ditampilkan, sementara konten apa pun yang meluas di luar wilayah kliping yang dipotong (yaitu, tidak ditampilkan). (Diperoleh dari Visual)
Comment	String yang akan dikaitkan dengan CompositionObject. (Diperoleh dari CompositionObject)
CompositeMode	Menentukan bagaimana bitmap visual dipadukan dengan layar. (Diperoleh dari Visual)
Compositor	Compositor digunakan untuk membuat CompositionObject ini. (Diperoleh dari CompositionObject)
Dispatcher	Dispatcher untuk CompositionObject. (Diperoleh dari CompositionObject)
DispatcherQueue	Mendapatkan DispatcherQueue untuk CompostionObject. (Diperoleh dari CompositionObject)
ImplicitAnimations	Kumpulan animasi implisit yang melekat pada objek ini. (Diperoleh dari CompositionObject)
IsHitTestVisible	Mendapatkan atau menetapkan nilai yang menunjukkan apakah sub-pohon visual yang berakar pada visual ini berpartisipasi dalam pengujian temuan. (Diperoleh dari Visual)
IsPixelSnappingEnabled	Mendapatkan atau menetapkan nilai yang menunjukkan apakah mesin komposisi menyelaraskan visual yang dirender dengan batas piksel. (Diperoleh dari Visual)
IsVisible	Menunjukkan apakah visual dan seluruh subtree visual anak terlihat. (Diperoleh dari Visual)
Offset	Offset visual relatif terhadap induknya atau untuk visual akar offset relatif terhadap sudut kiri atas jendela yang menghosting visual. Bisa dianimasikan. (Diperoleh dari Visual)
Opacity	Keburaman visual. Bisa dianimasikan. Properti opasitas menentukan transparansi, jika ada, dari Visual dan merupakan nilai dari 0 hingga 1. 0 sepenuhnya transparan dan 1 buram penuh. Visual dengan properti Opasitas 0 masih ada di pohon. Seperti properti lain pada Visual, Opacity dapat dianimasikan menggunakan Windows,UI. Sistem animasi komposisi. (Diperoleh dari Visual)
Orientation	Kuaternion yang menjelaskan orientasi dan rotasi dalam ruang 3D yang akan diterapkan ke visual. Bisa dianimasikan. (Diperoleh dari Visual)
Parent	Induk visual. (Diperoleh dari Visual)
ParentForTransform	Visual yang menentukan sistem koordinat tempat visual ini disusam. (Diperoleh dari Visual)
Properties	Kumpulan properti yang terkait dengan CompositionObject. (Diperoleh dari CompositionObject)
RelativeOffsetAdjustment	Menentukan offset visual sehubungan dengan ukuran visual induknya. (Diperoleh dari Visual)
RelativeSizeAdjustment	Mendapatkan atau mengatur ukuran visual sehubungan dengan ukuran visual induknya. (Diperoleh dari Visual)
RotationAngle	Sudut rotasi dalam radian visual. Bisa dianimasikan. (Diperoleh dari Visual)
RotationAngleInDegrees	Sudut rotasi visual dalam derajat. Bisa dianimasikan. (Diperoleh dari Visual)
RotationAxis	Sumbu untuk memutar visual. Bisa dianimasikan. (Diperoleh dari Visual)
Scale	Skala yang akan diterapkan ke visual. (Diperoleh dari Visual)
Shadow	Bayangan untuk SpriteVisual.
Size	Lebar dan tinggi visual. Bisa dianimasikan. (Diperoleh dari Visual)
TransformMatrix	Matriks transformasi untuk diterapkan ke visual. Bisa dianimasikan. (Diperoleh dari Visual)

Metode

Close()	Menutup CompositionObject dan merilis sumber daya sistem. (Diperoleh dari CompositionObject)
ConnectAnimation(String, CompositionAnimation)	Menyambungkan dan animasi. (Diperoleh dari CompositionObject)
DisconnectAnimation(String)	Memutuskan sambungan animasi. (Diperoleh dari CompositionObject)
Dispose()	Melakukan tugas yang ditentukan aplikasi yang terkait dengan membebaskan, melepaskan, atau mereset sumber daya yang tidak terkelola. (Diperoleh dari CompositionObject)
PopulatePropertyInfo(String, AnimationPropertyInfo)	Menentukan properti yang dapat dianimasikan. (Diperoleh dari CompositionObject)
StartAnimation(String, CompositionAnimation)	Menyambungkan animasi dengan properti objek yang ditentukan dan memulai animasi. (Diperoleh dari CompositionObject)
StartAnimation(String, CompositionAnimation, AnimationController)	Menyambungkan animasi dengan properti objek yang ditentukan dan memulai animasi. (Diperoleh dari CompositionObject)
StartAnimationGroup(ICompositionAnimationBase)	Memulai grup animasi. Metode StartAnimationGroup pada CompositionObject memungkinkan Anda memulai KomposisiAnimationGroup. Semua animasi dalam grup akan dimulai pada saat yang sama pada objek. (Diperoleh dari CompositionObject)
StopAnimation(String)	Memutuskan sambungan animasi dari properti yang ditentukan dan menghentikan animasi. (Diperoleh dari CompositionObject)
StopAnimationGroup(ICompositionAnimationBase)	Menghentikan grup animasi. (Diperoleh dari CompositionObject)
TryGetAnimationController(String)	Mengembalikan AnimationController untuk animasi yang berjalan pada properti yang ditentukan. (Diperoleh dari CompositionObject)

Berlaku untuk