ContainerVisual Sınıf

Tanım

Ad Alanı:

System.Windows.Media

Bütünleştirilmiş Kod:

PresentationCore.dll

Bir nesne koleksiyonunu Visual yönetir.

public ref class ContainerVisual : System::Windows::Media::Visual

public class ContainerVisual : System.Windows.Media.Visual

type ContainerVisual = class
    inherit Visual

Public Class ContainerVisual
Inherits Visual

Devralma

Object

DispatcherObject

DependencyObject

Visual

ContainerVisual

Türetilmiş

System.Windows.Media.DrawingVisual

System.Windows.Media.HostVisual

Örnekler

Aşağıdaki örnekte, iki DrawingVisual nesne için üst öğe olarak kullanılan bir ContainerVisual nesnenin nasıl oluşturulacağı gösterilmektedir. Nesneye eklenen nesnelerin doğru çizim sırasına göre işlendiğinden ContainerVisual emin olmak için ters z sırasına (yukarıdan aşağıya) eklenmesi gerekir. Görsel ağacının doğru numaralandırılabilmesi için örnek, yöntemin ve VisualChildrenCount özelliğin GetVisualChild geçersiz kılınan uygulamalarını sağlar.

// Create a host visual derived from the FrameworkElement class.
// This class provides layout, event handling, and container support for
// the child visual objects.
public class MyContainerVisualHost : FrameworkElement
{
    private ContainerVisual _containerVisual;

    public MyContainerVisualHost(DrawingVisual border, DrawingVisual text)
    {
        // Create a ContainerVisual to hold DrawingVisual children.
        _containerVisual = new ContainerVisual();

        // Add children to ContainerVisual in reverse z-order (bottom to top).
        _containerVisual.Children.Add(border);
        _containerVisual.Children.Add(text);

        // Create parent-child relationship with host visual and ContainerVisual.
        this.AddVisualChild(_containerVisual);
    }

    // Provide a required override for the VisualChildrenCount property.
    protected override int VisualChildrenCount
    {
        get { return _containerVisual == null ? 0 : 1; }
    }

    // Provide a required override for the GetVisualChild method.
    protected override Visual GetVisualChild(int index)
    {
        if (_containerVisual == null)
        {
            throw new ArgumentOutOfRangeException();
        }

        return _containerVisual;
    }
}

' Create a host visual derived from the FrameworkElement class.
' This class provides layout, event handling, and container support for
' the child visual objects.
Public Class MyContainerVisualHost
    Inherits FrameworkElement
    Private _containerVisual As ContainerVisual

    Public Sub New(ByVal border As DrawingVisual, ByVal text As DrawingVisual)
        ' Create a ContainerVisual to hold DrawingVisual children.
        _containerVisual = New ContainerVisual()

        ' Add children to ContainerVisual in reverse z-order (bottom to top).
        _containerVisual.Children.Add(border)
        _containerVisual.Children.Add(text)

        ' Create parent-child relationship with host visual and ContainerVisual.
        Me.AddVisualChild(_containerVisual)
    End Sub

    ' Provide a required override for the VisualChildrenCount property.
    Protected Overrides ReadOnly Property VisualChildrenCount() As Integer
        Get
            Return If(_containerVisual Is Nothing, 0, 1)
        End Get
    End Property

    ' Provide a required override for the GetVisualChild method.
    Protected Overrides Function GetVisualChild(ByVal index As Integer) As Visual
        If _containerVisual Is Nothing Then
            Throw New ArgumentOutOfRangeException()
        End If

        Return _containerVisual
    End Function
End Class

Açıklamalar

ContainerVisual sınıfı, bir nesne koleksiyonu Visual için kapsayıcı olarak kullanılır. sınıfı DrawingVisual sınıfından ContainerVisual türetilir, böylece DrawingVisual sınıfı bir görsel nesne koleksiyonu da içerebilir.

Oluşturucular

Name	Description
ContainerVisual()	sınıfının yeni bir örneğini ContainerVisual oluşturur.

Özellikler

Name	Description
BitmapEffect	Geçersiz. için ContainerVisualbir BitmapEffect değer alır veya ayarlar.
BitmapEffectInput	Geçersiz. için ContainerVisualbir BitmapEffectInput değer alır veya ayarlar.
CacheMode	öğesinin önbelleğe alınmış bir gösterimini ContainerVisualalır veya ayarlar.
Children	alt koleksiyonunu ContainerVisualalır.
Clip	öğesinin kırpma bölgesini ContainerVisualalır veya ayarlar.
ContentBounds	içeriğinin ContainerVisualsınırlayıcı kutusunu alır.
DependencyObjectType	DependencyObjectType Bu örneğin CLR türünü sarmalayan öğesini alır. (Devralındığı yer: DependencyObject)
DescendantBounds	öğesinin tüm alt öğeleri için tüm içerik sınırlayıcı kutuların birleşimini ContainerVisualalır, ancak içeriğini ContainerVisualiçermez.
Dispatcher	Dispatcher Bunun DispatcherObject ilişkili olduğu öğesini alır. (Devralındığı yer: DispatcherObject)
Effect	bit eşlem efektini uygulaması için ContainerVisualalır veya ayarlar.
IsSealed	Bu örneğin şu anda korumalı (salt okunur) olup olmadığını gösteren bir değer alır. (Devralındığı yer: DependencyObject)
Offset	öğesinin uzaklık değerini ContainerVisual başvuru noktasından alır veya ayarlar.
Opacity	0=saydam, 1=opak temelinde öğesinin ContainerVisualopaklığını alır veya ayarlar.
OpacityMask	için ContainerVisualolası bir opaklık maskesi belirten bir fırça alır veya ayarlar.
Parent	için üst öğeyi VisualContainerVisualalır.
Transform	öğesine uygulanan ContainerVisualdönüşümü alır veya ayarlar.
VisualBitmapEffect	Geçersiz. değerini BitmapEffectalır veya ayarlarVisual. (Devralındığı yer: Visual)
VisualBitmapEffectInput	Geçersiz. değerini BitmapEffectInputalır veya ayarlarVisual. (Devralındığı yer: Visual)
VisualBitmapScalingMode	için BitmapScalingModeöğesini Visual alır veya ayarlar. (Devralındığı yer: Visual)
VisualCacheMode	öğesinin önbelleğe alınmış bir gösterimini Visualalır veya ayarlar. (Devralındığı yer: Visual)
VisualChildrenCount	için ContainerVisualalt öğe sayısını alır.
VisualClearTypeHint	ClearType'ın ClearTypeHint içinde Visualnasıl işleneceğini belirleyen öğesini alır veya ayarlar. (Devralındığı yer: Visual)
VisualClip	değerinin küçük resim bölgesini Visual bir Geometry değer olarak alır veya ayarlar. (Devralındığı yer: Visual)
VisualEdgeMode	değerinin kenar modunu Visual bir EdgeMode değer olarak alır veya ayarlar. (Devralındığı yer: Visual)
VisualEffect	bit eşlem efektini uygulaması için Visualalır veya ayarlar. (Devralındığı yer: Visual)
VisualOffset	Görsel nesnesinin uzaklık değerini alır veya ayarlar. (Devralındığı yer: Visual)
VisualOpacity	öğesinin opaklığını Visualalır veya ayarlar. (Devralındığı yer: Visual)
VisualOpacityMask	opaklık maskesini BrushVisualtemsil eden değeri alır veya ayarlar. (Devralındığı yer: Visual)
VisualParent	Görsel nesnenin görsel ağaç üst öğesini alır. (Devralındığı yer: Visual)
VisualScrollableAreaClip	için Visualkırpılmış kaydırılabilir bir alan alır veya ayarlar. (Devralındığı yer: Visual)
VisualTextHintingMode	öğesini alır veya ayarlar TextHintingModeVisual. (Devralındığı yer: Visual)
VisualTextRenderingMode	öğesini alır veya ayarlar TextRenderingModeVisual. (Devralındığı yer: Visual)
VisualTransform	değerini Transformalır veya ayarlarVisual. (Devralındığı yer: Visual)
VisualXSnappingGuidelines	x koordinatı (dikey) kılavuz koleksiyonunu alır veya ayarlar. (Devralındığı yer: Visual)
VisualYSnappingGuidelines	y koordinatı (yatay) kılavuz koleksiyonunu alır veya ayarlar. (Devralındığı yer: Visual)
XSnappingGuidelines	için X (yatay) yönergesini ContainerVisualalır veya ayarlar.
YSnappingGuidelines	için Y (dikey) yönergesini ContainerVisualalır veya ayarlar.

Yöntemler

Name	Description
AddVisualChild(Visual)	İki görsel arasındaki üst-alt öğe ilişkisini tanımlar. (Devralındığı yer: Visual)
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. (Devralındığı yer: Visual)
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 ContainerVisualöğesi için belirtilen bir alt öğeyi Visual döndürür.
HitTest(HitTestFilterCallback, HitTestResultCallback, HitTestParameters)	ve HitTestResultCallback nesnelerini kullanarak HitTestFilterCallback üzerinde ContainerVisual bir isabet testi başlatır.
HitTest(Point)	bir belirterek Pointisabet testinin en üstteki görsel nesnesini döndürür.
HitTestCore(GeometryHitTestParameters)	Geometri değerinin görsel nesnenin sınırları içinde olup olmadığını belirler. (Devralındığı yer: Visual)
HitTestCore(PointHitTestParameters)	Nokta koordinat değerinin görsel nesnenin sınırları içinde olup olmadığını belirler. (Devralındığı yer: Visual)
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. (Devralındığı yer: Visual)
IsDescendantOf(DependencyObject)	Görsel nesnesinin, ata görsel nesnesinin alt öğesi olup olmadığını belirler. (Devralındığı yer: Visual)
OnDpiChanged(DpiScale, DpiScale)	Bu Görünümün işlendiği DPI değiştiğinde çağrılır. (Devralındığı yer: Visual)
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. (Devralındığı yer: Visual)
OnVisualParentChanged(DependencyObject)	Görsel nesnenin üst öğesi değiştirildiğinde çağrılır. (Devralındığı yer: Visual)
PointFromScreen(Point)	Ekran koordinatlarındaki koordinatları Point , geçerli koordinat sistemini temsil eden bir'e PointVisualdönüştürür. (Devralındığı yer: Visual)
PointToScreen(Point)	geçerli koordinat sistemini Point temsil eden bir'i VisualPoint ekran koordinatlarına dönüştürür. (Devralındığı yer: Visual)
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. (Devralındığı yer: Visual)
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. (Devralındığı yer: Visual)
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. (Devralındığı yer: Visual)
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. (Devralındığı yer: Visual)
TransformToVisual(Visual)	koordinatları Visual belirtilen görsel nesnesine dönüştürmek için kullanılabilecek bir dönüşüm döndürür. (Devralındığı yer: Visual)
VerifyAccess()	Çağıran iş parçacığının bu DispatcherObjectöğesine erişmesini zorlar. (Devralındığı yer: DispatcherObject)