Visual Kelas

Definisi

Ruang nama:

Windows.UI.Composition

Objek visual dasar dalam hierarki visual.

public ref class Visual : CompositionObject

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

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

Public Class Visual
Inherits CompositionObject

Warisan

Object Platform::Object IInspectable CompositionObject Visual

Turunan

Windows.UI.Composition.ContainerVisual

Windows.UI.Composition.DelegatedInkTrailVisual

Atribut

ContractVersionAttribute MarshalingBehaviorAttribute ThreadingAttribute

Persyaratan Windows

Rangkaian perangkat	Windows 10 (diperkenalkan dalam 10.0.10240.0)
API contract	Windows.Foundation.UniversalApiContract (diperkenalkan dalam v1.0)

Keterangan

Objek visual menyusun dan merender konten gambar berseri dan membentuk dasar sistem visual mode yang dipertahankan. Kelas Visual mendukung posisi dasar dan kliping dan dapat memiliki transformasi 2D dan 3D yang diterapkan padanya. Fungsionalitas tambahan seperti warna solid, gambar, dan konten dengan efek disediakan melalui subkelas seperti SpriteVisual atau ContainerVisual, dan dengan mengatur properti Brush visual ke subkelas CompositionBrush seperti KomposisiColorBrush, KomposisiEffectBrush, atau KomposisiSurfaceBrush.

Objek visual agile utas dan tidak terikat ke utas UI.

Properti yang dapat dianimasikan

Properti berikut dapat dianimasikan. Panggil CompositionObject.StartAnimation untuk mengaitkan properti dengan CompositionAnimation.

• Ukuran
• Offset
• Keburaman
• Orientasi
• CenterPoint
• RotationAngle
• RotationAngleInDegrees
• RotationAxis
• TransformMatrix

Rotasi

Visual mendukung dua bentuk rotasi:

• sudut sumbu

  Rotasi sudut sumbu menggunakan properti RotationAngle, RotationAxis, dan CenterPoint untuk menentukan rotasi dalam derajat, sumbu mana yang akan berputar, dan titik tengah visual untuk berputar.

• Orientasi

  Rotasi menurut orientasi menggunakan properti Orientasi untuk menentukan kuaternion yang menjelaskan orientasi dan rotasi dalam ruang 3D.

Riwayat versi

Versi Windows	Versi SDK	Nilai ditambahkan
1703	15063	ParentForTransform
1703	15063	RelativeOffsetAdjustment
1703	15063	RelativeSizeAdjustment

Properti

AnchorPoint	Titik pada visual yang akan diposisikan pada offset visual. Nilai dinormalisasi sehubungan dengan ukuran visual. Bisa dianimasikan.
BackfaceVisibility	Menentukan apakah wajah belakang visual harus terlihat selama transformasi 3D.
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.
CenterPoint	Titik tentang rotasi atau penskalaan mana yang terjadi. Dapat dianimasikan
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 dipotong (yaitu, tidak ditampilkan).
Comment	String yang akan dikaitkan dengan CompositionObject. (Diperoleh dari CompositionObject)
CompositeMode	Menentukan bagaimana bitmap visual dipadukan dengan layar.
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 obyek ini. (Diperoleh dari CompositionObject)
IsHitTestVisible	Mendapatkan atau menetapkan nilai yang menunjukkan apakah sub-pohon visual yang berakar pada visual ini berpartisipasi dalam pengujian temuan.
IsPixelSnappingEnabled	Mendapatkan atau menetapkan nilai yang menunjukkan apakah mesin komposisi menyelaraskan visual yang dirender dengan batas piksel.
IsVisible	Menunjukkan apakah visual dan seluruh subtree visual anak terlihat.
Offset	Offset visual relatif terhadap induknya atau untuk visual akar offset relatif terhadap sudut kiri atas jendela yang menghosting visual. Bisa dianimasikan.
Opacity	Tingkat 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 Opacity 0 masih ada di pohon. Seperti properti lain pada Visual, Opacity dapat dianimasikan menggunakan Windows,UI. Sistem animasi komposisi.
Orientation	Kuaternion yang menjelaskan orientasi dan rotasi dalam ruang 3D yang akan diterapkan ke visual. Bisa dianimasikan.
Parent	Induk visual.
ParentForTransform	Visual yang menentukan sistem koordinat tempat visual ini disusung.
Properties	Kumpulan properti yang terkait dengan CompositionObject. (Diperoleh dari CompositionObject)
RelativeOffsetAdjustment	Menentukan offset visual sehubungan dengan ukuran visual induknya.
RelativeSizeAdjustment	Mendapatkan atau mengatur ukuran visual sehubungan dengan ukuran visual induknya.
RotationAngle	Sudut rotasi dalam radian visual. Bisa dianimasikan.
RotationAngleInDegrees	Sudut rotasi visual dalam derajat. Bisa dianimasikan.
RotationAxis	Sumbu untuk memutar visual. Bisa dianimasikan.
Scale	Skala yang akan diterapkan ke visual.
Size	Lebar dan tinggi visual. Bisa dianimasikan.
TransformMatrix	Matriks transformasi untuk diterapkan ke visual. Bisa dianimasikan.

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, merilis, atau mengatur ulang sumber daya yang tidak dikelola. (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 CompositionAnimationGroup. 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)

Lihat juga

• CompositionObject
• IClosable
• Gambaran Umum Pohon Visual Komposisi
• Visual komposisi tanpa sampel kerangka kerja (Windows 10)