Visual Sınıf

Tanım

Ad Alanı:

System.Windows.Media

Bütünleştirilmiş Kod:

PresentationCore.dll

WPF'de isabet testi, eşgüdümlü dönüştürme ve sınırlayıcı kutu hesaplamalarını içeren işleme desteği sağlar.

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

public abstract class Visual : System.Windows.DependencyObject

type Visual = class
    inherit DependencyObject

Public MustInherit Class Visual
Inherits DependencyObject

Devralma

Object

DispatcherObject

DependencyObject

Visual

Türetilmiş

System.Windows.Media.ContainerVisual

System.Windows.Media.Media3D.Viewport3DVisual

System.Windows.UIElement

Açıklamalar

Visual sınıfı, her FrameworkElement nesnenin türetildiği temel soyutlamadır. Ayrıca WPF'de yeni denetimler yazmak için giriş noktası işlevi görür ve birçok şekilde Win32 uygulama modelindeki bir pencere tutamacının (HWND) eşdeğeri olarak düşünülebilir.

Visual nesnesi, birincil rolü işleme desteği sağlamak olan çekirdek bir WPF nesnesidir. ve Buttongibi TextBox kullanıcı arabirimi denetimleri sınıfından Visual türetilir ve işleme verilerini kalıcı hale için tanımlı özellikleri kullanırVisual. Visual nesnesi aşağıdakiler için destek sağlar:

• Çıktı görüntüsü: Görselin kalıcı, serileştirilmiş çizim içeriğini işleme.

• Dönüşümler: Bir görselde dönüştürmeler gerçekleştirme.

• Kırpma: Bir görsel için kırpma bölgesi desteği sağlama.

• İsabet testi: Belirtilen koordinatın (nokta) veya geometrinin görselin sınırları içinde yer alıp almadığını belirleme.

• Sınırlayıcı kutu hesaplamaları: Görselin sınırlayıcı dikdörtgenini belirleme.

Mimari olarak, Visual nesnesi aşağıdaki gibi hemen işlenmesiyle ilgili olmayan diğer uygulama geliştirme gereksinimleri / WPF özellikleri için destek içermez:

• Etkinlik yönetimi

• Tasarım Düzeni

• Stili

• Veri bağlama

• Genelleştirme

Visual , daha fazla sınıfın türetilebileceği genel bir soyut sınıf olarak sağlanır. Aşağıdaki çizimde WPF mimarisinde tanımlanan mevcut görsel nesnelerin hiyerarşisi gösterilmektedir.

Görsel sınıf hiyerarşisi

Bazı durumlarda, içinde Visual korumalı olarak tanımlanan üyeler, türetilmiş UIElement sınıfta benzer adlara sahip daha kolay erişilebilir üyeler olarak kullanıma sunulur.

Daha fazla bilgi için bkz. WPF Grafik İşlemeye Genel Bakış.

A Visual sınırlı sayıda düzeye sahiptir. .NET Framework'ün önceki sürümlerinde bu maksimum derinlik 255'ti. Bu sınır, görsel ağacında çok sayıda düzeyi olan bazı düzenler için yetersizdir.

.NET Framework 4'te en fazla 2047 derinliği Visual , çok daha derin görsel ağaçlara olanak tanır. Çoğu uygulamada, bu kadar çok düzeyde geçiş yapmak için yeterli yığın alanı yoktur ve sonuç düzen sırasında olur StackOverflowException . Varsayılan yığın boyutu için bu özel durum genellikle ağaç derinliği yaklaşık 800 olduğunda oluşur ve bu da yaklaşık 190 iç içe TreeViewItem nesneye karşılık gelir.

Bu özel durum uygulamanız tarafından oluşturulursa ve daha derin bir görsel ağacınız olması gerekiyorsa, uygulamanın yığın boyutunu artırabilirsiniz. Derleme zamanında /STACK seçeneğini kullanarak veya EDITBIN yardımcı programını kullanarak yığının boyutunu artırabilirsiniz. Yığın boyutunu artırmak uygulamanızın performansını etkileyebilir. Daha fazla bilgi için bkz . Yığın Ayırmaları ve EDITBIN Seçenekleri.

Oluşturucular

Name	Description
Visual()	sınıfından türetilen Visual nesneler için temel başlatma sağlar.

Özellikler

Name	Description
DependencyObjectType	DependencyObjectType Bu örneğin CLR türünü sarmalayan öğesini alır. (Devralındığı yer: DependencyObject)
Dispatcher	Dispatcher Bunun DispatcherObject ilişkili olduğu öğesini alır. (Devralındığı yer: DispatcherObject)
IsSealed	Bu örneğin şu anda korumalı (salt okunur) olup olmadığını gösteren bir değer alır. (Devralındığı yer: DependencyObject)
VisualBitmapEffect	Geçersiz. değerini BitmapEffectalır veya ayarlarVisual.
VisualBitmapEffectInput	Geçersiz. değerini BitmapEffectInputalır veya ayarlarVisual.
VisualBitmapScalingMode	için BitmapScalingModeöğesini Visual alır veya ayarlar.
VisualCacheMode	öğesinin önbelleğe alınmış bir gösterimini Visualalır veya ayarlar.
VisualChildrenCount	için Visualalt öğe sayısını alır.
VisualClearTypeHint	ClearType'ın ClearTypeHint içinde Visualnasıl işleneceğini belirleyen öğesini alır veya ayarlar.
VisualClip	değerinin küçük resim bölgesini Visual bir Geometry değer olarak alır veya ayarlar.
VisualEdgeMode	değerinin kenar modunu Visual bir EdgeMode değer olarak alır veya ayarlar.
VisualEffect	bit eşlem efektini uygulaması için Visualalır veya ayarlar.
VisualOffset	Görsel nesnesinin uzaklık değerini alır veya ayarlar.
VisualOpacity	öğesinin opaklığını Visualalır veya ayarlar.
VisualOpacityMask	opaklık maskesini BrushVisualtemsil eden değeri alır veya ayarlar.
VisualParent	Görsel nesnenin görsel ağaç üst öğesini alır.
VisualScrollableAreaClip	için Visualkırpılmış kaydırılabilir bir alan alır veya ayarlar.
VisualTextHintingMode	öğesini alır veya ayarlar TextHintingModeVisual.
VisualTextRenderingMode	öğesini alır veya ayarlar TextRenderingModeVisual.
VisualTransform	değerini Transformalır veya ayarlarVisual.
VisualXSnappingGuidelines	x koordinatı (dikey) kılavuz koleksiyonunu alır veya ayarlar.
VisualYSnappingGuidelines	y koordinatı (yatay) kılavuz koleksiyonunu alır veya ayarlar.

Yöntemler

Name	Description
AddVisualChild(Visual)	İki görsel arasındaki üst-alt öğe ilişkisini tanımlar.
CheckAccess()	Çağıran iş parçacığının bu DispatcherObjectöğesine erişimi olup olmadığını belirler. (Devralındığı yer: DispatcherObject)
ClearValue(DependencyProperty)	Bir özelliğin yerel değerini temizler. Temizlenecek özellik bir DependencyProperty tanımlayıcı tarafından belirtilir. (Devralındığı yer: DependencyObject)
ClearValue(DependencyPropertyKey)	Salt okunur özelliğin yerel değerini temizler. Temizlenecek özellik tarafından DependencyPropertyKeybelirtilir. (Devralındığı yer: DependencyObject)
CoerceValue(DependencyProperty)	Belirtilen bağımlılık özelliğinin değerini zorlama. Bu, çağrısında CoerceValueCallbackvar olan bağımlılık özelliği için özellik meta verilerinde belirtilen herhangi bir DependencyObject işlevi çağırarak gerçekleştirilir. (Devralındığı yer: DependencyObject)
Equals(Object)	Sağlanan DependencyObject öğesinin geçerli DependencyObjectile eşdeğer olup olmadığını belirler. (Devralındığı yer: DependencyObject)
FindCommonVisualAncestor(DependencyObject)	İki görsel nesnenin ortak atasını döndürür.
GetHashCode()	Bu DependencyObjectiçin bir karma kodu alır. (Devralındığı yer: DependencyObject)
GetLocalValueEnumerator()	Hangi bağımlılık özelliklerinin bu DependencyObjectüzerinde yerel olarak ayarlı değerlere sahip olduğunu belirlemek için özel bir numaralandırıcı oluşturur. (Devralındığı yer: DependencyObject)
GetValue(DependencyProperty)	Bir öğesinin bu örneğindeki bir bağımlılık özelliğinin DependencyObjectgeçerli etkin değerini döndürür. (Devralındığı yer: DependencyObject)
GetVisualChild(Int32)	Üst Visualöğesinde belirtilen VisualCollection değerini döndürür.
HitTestCore(GeometryHitTestParameters)	Geometri değerinin görsel nesnenin sınırları içinde olup olmadığını belirler.
HitTestCore(PointHitTestParameters)	Nokta koordinat değerinin görsel nesnenin sınırları içinde olup olmadığını belirler.
InvalidateProperty(DependencyProperty)	Belirtilen bağımlılık özelliği için geçerli değeri yeniden değerlendirir. (Devralındığı yer: DependencyObject)
IsAncestorOf(DependencyObject)	Görsel nesnesinin alt görsel nesnesinin bir atası olup olmadığını belirler.
IsDescendantOf(DependencyObject)	Görsel nesnesinin, ata görsel nesnesinin alt öğesi olup olmadığını belirler.
OnDpiChanged(DpiScale, DpiScale)	Bu Görünümün işlendiği DPI değiştiğinde çağrılır.
OnPropertyChanged(DependencyPropertyChangedEventArgs)	Bunun DependencyObject üzerindeki herhangi bir bağımlılık özelliğinin etkin değeri her güncelleştirildiğinde çağrılır. Değiştirilen belirli bağımlılık özelliği olay verilerinde bildirilir. (Devralındığı yer: DependencyObject)
OnVisualChildrenChanged(DependencyObject, DependencyObject)	Görsel nesnesinin adı değiştirildiğinde VisualCollection çağrılır.
OnVisualParentChanged(DependencyObject)	Görsel nesnenin üst öğesi değiştirildiğinde çağrılır.
PointFromScreen(Point)	Ekran koordinatlarındaki koordinatları Point , geçerli koordinat sistemini temsil eden bir'e PointVisualdönüştürür.
PointToScreen(Point)	geçerli koordinat sistemini Point temsil eden bir'i VisualPoint ekran koordinatlarına dönüştürür.
ReadLocalValue(DependencyProperty)	Varsa, bağımlılık özelliğinin yerel değerini döndürür. (Devralındığı yer: DependencyObject)
RemoveVisualChild(Visual)	İki görsel arasındaki üst-alt ilişkiyi kaldırır.
SetCurrentValue(DependencyProperty, Object)	Bir bağımlılık özelliğinin değerini, değer kaynağını değiştirmeden ayarlar. (Devralındığı yer: DependencyObject)
SetValue(DependencyProperty, Object)	Bağımlılık özelliği tanımlayıcısı tarafından belirtilen bir bağımlılık özelliğinin yerel değerini ayarlar. (Devralındığı yer: DependencyObject)
SetValue(DependencyPropertyKey, Object)	Bağımlılık özelliğinin tanımlayıcısı tarafından belirtilen salt okunur bağımlılık özelliğinin DependencyPropertyKey yerel değerini ayarlar. (Devralındığı yer: DependencyObject)
ShouldSerializeProperty(DependencyProperty)	Serileştirme işlemlerinin sağlanan bağımlılık özelliği için değeri serileştirmesi gerekip gerekmediğini gösteren bir değer döndürür. (Devralındığı yer: DependencyObject)
TransformToAncestor(Visual)	koordinatlarını görsel nesnesinin belirtilen Visual üst öğesinden Visual dönüştürmek için kullanılabilecek bir dönüşüm döndürür.
TransformToAncestor(Visual3D)	koordinatlarını görsel nesnesinin belirtilen Visual üst öğesinden Visual3D dönüştürmek için kullanılabilecek bir dönüşüm döndürür.
TransformToDescendant(Visual)	Koordinatları öğesinden Visual belirtilen görsel nesne alt öğesine dönüştürmek için kullanılabilecek bir dönüşüm döndürür.
TransformToVisual(Visual)	koordinatları Visual belirtilen görsel nesnesine dönüştürmek için kullanılabilecek bir dönüşüm döndürür.
VerifyAccess()	Çağıran iş parçacığının bu DispatcherObjectöğesine erişmesini zorlar. (Devralındığı yer: DispatcherObject)

Ayrıca bkz.

• VisualCollection
• VisualTreeHelper