Visual Sınıf

Tanım

WPF'de isabet testi, eşgüdümlü dönüştürme ve sınırlayıcı kutu hesaplamaları 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
    interface DUCE.IResource
type Visual = class
    inherit DependencyObject
Public MustInherit Class Visual
Inherits DependencyObject
Devralma
Türetilmiş

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 TextBoxgibi Button 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:

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

  • Dönüşümler: Görsel üzerinde dönüştürme gerçekleştirme.

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

  • İsabet testi: Belirtilen koordinatın (nokta) veya geometrinin bir görselin sınırları içinde bulunup bulunmadığı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 işlemesiyle hemen ilgili olmayan diğer uygulama geliştirme gereksinimleri / WPF özellikleri için destek içermez:

  • Olay işleme

  • Layout

  • Stiller

  • Veri bağlama

  • Genelleştirme

Visual , başka sınıfları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.

Visual nesnesinden türetilen sınıfların diyagramı
Görsel sınıf hiyerarşisi

Bazı durumlarda, içinde Visual korumalı olarak tanımlanan üyeler, türetilen 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 önceki sürümlerinde bu maksimum derinlik 255'ti. Bu sınır, görsel ağacında birçok düzeye sahip bazı düzenler için yetersizdir.

.NET Framework 4'te maksimum derinlik Visual 2047'dir ve bu da çok daha derin görsel ağaçlar sağlar. Çoğu uygulamada, bu kadar çok düzeyde gezinmek 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şturulur ve bu da yaklaşık 190 iç içe TreeViewItem nesneye karşılık gelir.

Bu özel durum uygulamanız tarafından oluşturulduysa 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 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

Visual()

sınıfından türetilen nesneler için temel başlatmayı Visual sağlar.

Özellikler

DependencyObjectType

DependencyObjectType Bu örneğin CLR türünü sarmalayan öğesini alır.

(Devralındığı yer: DependencyObject)
Dispatcher

Dispatcher Bunun DispatcherObject ilişkili olduğunu 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
Kullanımdan kalktı.
Kullanımdan kalktı.

değerini Visualalır veya ayarlarBitmapEffect.

VisualBitmapEffectInput
Kullanımdan kalktı.
Kullanımdan kalktı.

değerini Visualalır veya ayarlarBitmapEffectInput.

VisualBitmapScalingMode

için Visualöğesini BitmapScalingMode 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 Brush Visualtemsil eden değeri alır veya ayarlar.

VisualParent

Görsel nesnesinin 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 TextHintingMode Visual.

VisualTextRenderingMode

öğesini alır veya ayarlar TextRenderingMode Visual.

VisualTransform

değerini Visualalır veya ayarlarTransform.

VisualXSnappingGuidelines

x koordinatı (dikey) kılavuz koleksiyonunu alır veya ayarlar.

VisualYSnappingGuidelines

y koordinatı (yatay) kılavuz koleksiyonunu alır veya ayarlar.

Yöntemler

AddVisualChild(Visual)

İki görsel arasındaki üst-alt ilişkiyi 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 var olan bağımlılık özelliği için özellik meta verilerinde belirtilen herhangi bir CoerceValueCallback işlevi çağırarak DependencyObjectgerç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ı 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 özelleştirilmiş bir numaralandırıcı oluşturur.

(Devralındığı yer: DependencyObject)
GetType()

Type Geçerli örneğini alır.

(Devralındığı yer: Object)
GetValue(DependencyProperty)

Bir öğesinin bu örneğindeki bağımlılık özelliğinin DependencyObjectgeçerli geçerli değerini döndürür.

(Devralındığı yer: DependencyObject)
GetVisualChild(Int32)

Üst VisualCollectionöğesinde belirtilen Visual 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.

MemberwiseClone()

Geçerli Objectöğesinin sığ bir kopyasını oluşturur.

(Devralındığı yer: Object)
OnDpiChanged(DpiScale, DpiScale)

Bu Görünümün işlendiği DPI değiştiğinde çağrılır.

OnPropertyChanged(DependencyPropertyChangedEventArgs)

Bu DependencyObject konudaki 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 öğesi 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 bir Point öğesini, geçerli koordinat sistemini temsil eden bir'e Point Visualdönüştürür.

PointToScreen(Point)

Point öğesinin geçerli koordinat sistemini Visual temsil eden bir öğesini ekran koordinatlarında bire Point 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)

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 bağımlılık özelliğinin yerel değerini ayarlar.

(Devralındığı yer: DependencyObject)
SetValue(DependencyPropertyKey, Object)

Salt okunur bağımlılık özelliğinin, bağımlılık özelliğinin DependencyPropertyKey tanımlayıcısı tarafından belirtilen 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)
ToString()

Geçerli nesneyi temsil eden dizeyi döndürür.

(Devralındığı yer: Object)
TransformToAncestor(Visual)

Koordinatları'ndan Visual görsel nesnenin belirtilen Visual üst öğesine dönüştürmek için kullanılabilecek bir dönüşüm döndürür.

TransformToAncestor(Visual3D)

Koordinatları'ndan Visual görsel nesnenin belirtilen Visual3D üst öğesine 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üştürme döndürür.

TransformToVisual(Visual)

koordinatları öğesinden Visual belirtilen görsel nesneye 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 DispatcherObjecterişimine sahip olmasını zorlar.

(Devralındığı yer: DispatcherObject)

Şunlara uygulanır

Ayrıca bkz.