Visual Kelas

Definisi

Ruang nama:: System.Windows.Media

Rakitan:: PresentationCore.dll

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.

Menyediakan dukungan penyajian dalam WPF, yang mencakup pengujian hit, transformasi koordinat, dan perhitungan kotak pembatas.

public ref class Visual abstract : System::Windows::DependencyObject

public abstract class Visual : System.Windows.DependencyObject

type Visual = class
    inherit DependencyObject
    interface DUCE.IResource

type Visual = class
    inherit DependencyObject

Public MustInherit Class Visual
Inherits DependencyObject

Warisan: Object

DispatcherObject

DependencyObject
Visual

Turunan: System.Windows.Media.ContainerVisual

System.Windows.Media.Media3D.Viewport3DVisual

System.Windows.UIElement

Keterangan

Kelas Visual adalah abstraksi dasar dari mana setiap objek FrameworkElement berasal. Ini juga berfungsi sebagai titik masuk untuk menulis kontrol baru di WPF, dan dalam banyak hal dapat dianggap sebagai setara dengan handel jendela (HWND) dalam model aplikasi Win32.

Objek Visual adalah objek WPF inti, yang peran utamanya adalah memberikan dukungan penyajian. Kontrol antarmuka pengguna, seperti Button dan TextBox, berasal dari Visual kelas , dan menggunakan properti yang Visual ditentukan untuk mempertahankan data penyajian mereka. Objek menyediakan Visual dukungan untuk yang berikut ini:

Tampilan output: Merender konten gambar visual yang dipertahankan dan diserialisasikan.
Transformasi: Melakukan transformasi pada visual.
Kliping: Menyediakan dukungan wilayah kliping untuk visual.
Pengujian hit: Menentukan apakah koordinat (titik) atau geometri tertentu terkandung dalam batas visual.
Perhitungan bingkai pembatas: Menentukan persegi panjang pembatas visual.

Secara arsitektur, Visual objek tidak menyertakan dukungan untuk persyaratan pengembangan aplikasi /fitur WPF lainnya yang tidak segera terkait dengan penyajiannya, seperti berikut:

Penanganan kejadian
Tata letak
Gaya Tampilan
Pengikatan data
Globalisasi

Visual disediakan sebagai kelas abstrak publik tempat kelas lebih lanjut dapat diturunkan. Ilustrasi berikut menunjukkan hierarki objek visual yang ada yang ditentukan dalam arsitektur WPF.

Diagram kelas yang berasal dari Diagram objek Visual Hierarki kelas visual

Dalam beberapa kasus, anggota yang didefinisikan sebagai dilindungi di Visual diekspos sebagai anggota yang lebih mudah diakses dengan nama serupa di kelas turunan UIElement .

Untuk informasi selengkapnya, lihat Gambaran Umum Penyajian Grafis WPF .

Memiliki Visual jumlah level yang terbatas. Dalam versi .NET Framework sebelumnya, kedalaman maksimum ini adalah 255. Batas ini tidak memadai untuk beberapa tata letak yang memiliki banyak tingkatan di pohon visual.

Di .NET Framework 4, kedalaman maksimum adalah Visual 2047, yang memungkinkan pohon visual yang jauh lebih dalam. Di sebagian besar aplikasi, tidak ada cukup ruang tumpukan untuk melintasi begitu banyak tingkat, dan hasilnya adalah StackOverflowException selama tata letak. Untuk ukuran tumpukan default, pengecualian ini biasanya dilemparkan ketika kedalaman pohon sekitar 800, yang sesuai dengan sekitar 190 objek berlapis TreeViewItem .

Jika pengecualian ini dilemparkan oleh aplikasi Anda dan Anda harus memiliki pohon visual yang lebih dalam, Anda dapat meningkatkan ukuran tumpukan aplikasi. Anda dapat meningkatkan ukuran tumpukan dengan menggunakan opsi /STACK pada waktu kompilasi atau dengan menggunakan utilitas EDITBIN. Meningkatkan ukuran tumpukan dapat memengaruhi performa aplikasi Anda. Untuk informasi selengkapnya, lihat Alokasi Tumpukan dan Opsi EDITBIN.

Konstruktor

Nama	Deskripsi
Visual()	Menyediakan inisialisasi dasar untuk objek yang berasal dari Visual kelas .

Properti

Nama	Deskripsi
DependencyObjectType	DependencyObjectType Mendapatkan yang membungkus jenis CLR instans ini. (Diperoleh dari DependencyObject)
Dispatcher	Dispatcher Mendapatkan ini DispatcherObject dikaitkan dengan. (Diperoleh dari DispatcherObject)
IsSealed	Mendapatkan nilai yang menunjukkan apakah instans ini saat ini disegel (baca-saja). (Diperoleh dari DependencyObject)
VisualBitmapEffect	Kedaluwarsa. Kedaluwarsa. Mendapatkan atau menetapkan BitmapEffect nilai untuk Visual.
VisualBitmapEffectInput	Kedaluwarsa. Kedaluwarsa. Mendapatkan atau menetapkan BitmapEffectInput nilai untuk Visual.
VisualBitmapScalingMode	Mendapatkan atau mengatur BitmapScalingMode untuk Visual.
VisualCacheMode	Mendapatkan atau mengatur representasi cache dari Visual.
VisualChildrenCount	Mendapatkan jumlah elemen anak untuk Visual.
VisualClearTypeHint	Mendapatkan atau mengatur ClearTypeHint yang menentukan bagaimana ClearType dirender di Visual.
VisualClip	Mendapatkan atau mengatur wilayah Visual klip sebagai Geometry nilai.
VisualEdgeMode	Mendapatkan atau mengatur mode Visual tepi sebagai EdgeMode nilai.
VisualEffect	Mendapatkan atau mengatur efek bitmap untuk diterapkan ke Visual.
VisualOffset	Mendapatkan atau mengatur nilai offset objek visual.
VisualOpacity	Mendapatkan atau mengatur keburaman dari Visual.
VisualOpacityMask	Mendapatkan atau menetapkan Brush nilai yang mewakili masker opasitas dari Visual.
VisualParent	Mendapatkan induk pohon visual dari objek visual.
VisualScrollableAreaClip	Mendapatkan atau mengatur area yang dapat digulir terklip untuk Visual.
VisualTextHintingMode	Mengambil atau menetapkan TextHintingMode dari Visual.
VisualTextRenderingMode	Mengambil atau menetapkan TextRenderingMode dari Visual.
VisualTransform	Mendapatkan atau menetapkan Transform nilai untuk Visual.
VisualXSnappingGuidelines	Mendapatkan atau mengatur koleksi pedoman koordinat x (vertikal).
VisualYSnappingGuidelines	Mendapatkan atau mengatur koleksi pedoman koordinat y (horizontal).

Metode

Nama	Deskripsi
AddVisualChild(Visual)	Menentukan hubungan induk-anak antara dua visual.
CheckAccess()	Menentukan apakah utas panggilan memiliki akses ke ini DispatcherObject. (Diperoleh dari DispatcherObject)
ClearValue(DependencyProperty)	Menghapus nilai lokal properti. Properti yang akan dihapus ditentukan oleh DependencyProperty pengidentifikasi. (Diperoleh dari DependencyObject)
ClearValue(DependencyPropertyKey)	Menghapus nilai lokal properti baca-saja. Properti yang akan dihapus ditentukan oleh DependencyPropertyKey. (Diperoleh dari DependencyObject)
CoerceValue(DependencyProperty)	Memaksa nilai properti dependensi yang ditentukan. Ini dilakukan dengan memanggil fungsi apa pun CoerceValueCallback yang ditentukan dalam metadata properti untuk properti dependensi seperti yang ada pada panggilan DependencyObject. (Diperoleh dari DependencyObject)
Equals(Object)	Menentukan apakah yang disediakan DependencyObject setara dengan saat ini DependencyObject. (Diperoleh dari DependencyObject)
FindCommonVisualAncestor(DependencyObject)	Mengembalikan leluhur umum dari dua objek visual.
GetHashCode()	Mendapatkan kode hash untuk ini DependencyObject. (Diperoleh dari DependencyObject)
GetLocalValueEnumerator()	Membuat enumerator khusus untuk menentukan properti dependensi mana yang telah mengatur nilai secara lokal pada ini DependencyObject. (Diperoleh dari DependencyObject)
GetType()	Mendapatkan Type instans saat ini. (Diperoleh dari Object)
GetValue(DependencyProperty)	Mengembalikan nilai efektif properti dependensi saat ini pada instans ini dari DependencyObject. (Diperoleh dari DependencyObject)
GetVisualChild(Int32)	Mengembalikan yang ditentukan Visual dalam induk VisualCollection.
HitTestCore(GeometryHitTestParameters)	Menentukan apakah nilai geometri berada dalam batas objek visual.
HitTestCore(PointHitTestParameters)	Menentukan apakah nilai koordinat titik berada dalam batas objek visual.
InvalidateProperty(DependencyProperty)	Mengevaluasi kembali nilai efektif untuk properti dependensi yang ditentukan. (Diperoleh dari DependencyObject)
IsAncestorOf(DependencyObject)	Menentukan apakah objek visual adalah leluhur dari objek visual turunan.
IsDescendantOf(DependencyObject)	Menentukan apakah objek visual adalah turunan dari objek visual leluhur.
MemberwiseClone()	Membuat salinan dangkal dari Objectsaat ini. (Diperoleh dari Object)
OnDpiChanged(DpiScale, DpiScale)	Dipanggil ketika DPI tempat Tampilan ini dirender berubah.
OnPropertyChanged(DependencyPropertyChangedEventArgs)	Dipanggil setiap kali nilai efektif dari properti dependensi apa pun pada ini DependencyObject telah diperbarui. Properti dependensi tertentu yang berubah dilaporkan dalam data peristiwa. (Diperoleh dari DependencyObject)
OnVisualChildrenChanged(DependencyObject, DependencyObject)	Dipanggil VisualCollection saat objek visual dimodifikasi.
OnVisualParentChanged(DependencyObject)	Dipanggil saat induk objek visual diubah.
PointFromScreen(Point)	Point Mengonversi koordinat dalam layar menjadi Point yang mewakili sistem koordinat Visualsaat ini dari .
PointToScreen(Point)	Point Mengonversi yang mewakili sistem koordinat saat ini dari Visual ke dalam koordinat Point layar.
ReadLocalValue(DependencyProperty)	Mengembalikan nilai lokal properti dependensi, jika ada. (Diperoleh dari DependencyObject)
RemoveVisualChild(Visual)	Menghapus hubungan induk-turunan antara dua visual.
SetCurrentValue(DependencyProperty, Object)	Mengatur nilai properti dependensi tanpa mengubah sumber nilainya. (Diperoleh dari DependencyObject)
SetValue(DependencyProperty, Object)	Mengatur nilai lokal properti dependensi, yang ditentukan oleh pengidentifikasi properti dependensinya. (Diperoleh dari DependencyObject)
SetValue(DependencyPropertyKey, Object)	Mengatur nilai lokal properti dependensi baca-saja, yang ditentukan oleh DependencyPropertyKey pengidentifikasi properti dependensi. (Diperoleh dari DependencyObject)
ShouldSerializeProperty(DependencyProperty)	Mengembalikan nilai yang menunjukkan apakah proses serialisasi harus membuat serialisasi nilai untuk properti dependensi yang disediakan. (Diperoleh dari DependencyObject)
ToString()	Mengembalikan string yang mewakili objek saat ini. (Diperoleh dari Object)
TransformToAncestor(Visual)	Mengembalikan transformasi yang dapat digunakan untuk mengubah koordinat dari Visual ke leluhur objek visual yang ditentukan Visual .
TransformToAncestor(Visual3D)	Mengembalikan transformasi yang dapat digunakan untuk mengubah koordinat dari Visual ke leluhur objek visual yang ditentukan Visual3D .
TransformToDescendant(Visual)	Mengembalikan transformasi yang dapat digunakan untuk mengubah koordinat Visual dari ke turunan objek visual yang ditentukan.
TransformToVisual(Visual)	Mengembalikan transformasi yang dapat digunakan untuk mengubah koordinat dari ke Visual objek visual yang ditentukan.
VerifyAccess()	Memberlakukan bahwa utas panggilan memiliki akses ke ini DispatcherObject. (Diperoleh dari DispatcherObject)

Berlaku untuk

Lihat juga

Saran dan Komentar

Apakah halaman ini membantu?