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 nesneler 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) eklenmelidir. 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

ContainerVisual()

ContainerVisual sınıfının yeni bir örneğini oluşturur.

Özellikler

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	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ın birleşimini ContainerVisualalır, ancak içeriğini ContainerVisualiçermez.
Dispatcher	Dispatcher Bunun DispatcherObject ilişkili olduğunu 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ı olup olmadığını belirten bir değer alır (salt okunur). (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ı opaklık maskesini 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 Visualalır veya ayarlarBitmapEffect. (Devralındığı yer: Visual)
VisualBitmapEffectInput	Geçersiz. değerini Visualalır veya ayarlarBitmapEffectInput. (Devralındığı yer: Visual)
VisualBitmapScalingMode	için Visualöğesini BitmapScalingMode 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 nesnesinin 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 Visualalır veya ayarlarTransform. (Devralındığı yer: Visual)
VisualXSnappingGuidelines	x koordinatı (dikey) yönerge 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

AddVisualChild(Visual)	İki görsel arasındaki üst-alt ilişkiyi 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 DependencyObjectvar olan bağımlılık özelliği için özellik meta verilerinde belirtilen herhangi bir CoerceValueCallback 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ı 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 ö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 ContainerVisualöğesi için belirtilen 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)
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. (Devralındığı yer: Visual)
OnPropertyChanged(DependencyPropertyChangedEventArgs)	Üzerindeki DependencyObject 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. (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 bir Point öğesini, geçerli koordinat sistemini temsil eden bir'e PointVisualdönüştürür. (Devralındığı yer: Visual)
PointToScreen(Point)	Point öğesinin geçerli koordinat sistemini Visual temsil eden bir öğesini ekran koordinatlarında bire Point 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 belirten 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. (Devralındığı yer: Visual)
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. (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üştürme döndürür. (Devralındığı yer: Visual)
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. (Devralındığı yer: Visual)
VerifyAccess()	Çağıran iş parçacığının bu DispatcherObjecterişimine sahip olmasını zorlar. (Devralındığı yer: DispatcherObject)