ContainerVisual Klasa

Definicja

Przestrzeń nazw:

System.Windows.Media

Zestaw:

PresentationCore.dll

Zarządza kolekcją Visual obiektów.

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

Dziedziczenie

Object

DispatcherObject

DependencyObject

Visual

ContainerVisual

Pochodne

System.Windows.Media.DrawingVisual

System.Windows.Media.HostVisual

Przykłady

W poniższym przykładzie pokazano, jak utworzyć ContainerVisual obiekt, który jest używany jako obiekt nadrzędny dla dwóch DrawingVisual obiektów. Obiekty dodawane do ContainerVisual obiektu muszą być dodawane w odwrotnej kolejności z (od dołu do góry), aby upewnić się, że są one renderowane w prawidłowej kolejności rysunku. Aby drzewo wizualne było poprawnie wyliczone, w przykładzie przedstawiono przesłonięte implementacje GetVisualChild metody i VisualChildrenCount właściwości.

// 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

Uwagi

Klasa ContainerVisual jest używana jako kontener dla kolekcji Visual obiektów. Klasa DrawingVisual pochodzi z ContainerVisual klasy, tak aby DrawingVisual klasa mogła również zawierać kolekcję obiektów wizualnych.

Konstruktory

ContainerVisual()

Tworzy nowe wystąpienie klasy ContainerVisual.

Właściwości

BitmapEffect	Przestarzałe. Pobiera lub ustawia BitmapEffect wartość dla elementu ContainerVisual.
BitmapEffectInput	Przestarzałe. Pobiera lub ustawia BitmapEffectInput wartość dla elementu ContainerVisual.
CacheMode	Pobiera lub ustawia w pamięci podręcznej reprezentację elementu ContainerVisual.
Children	Pobiera kolekcję podrzędną elementu ContainerVisual.
Clip	Pobiera lub ustawia region przycinania obiektu ContainerVisual.
ContentBounds	Pobiera pole ograniczenia zawartości elementu ContainerVisual.
DependencyObjectType	DependencyObjectType Pobiera opakowujący typ clR tego wystąpienia. (Odziedziczone po DependencyObject)
DescendantBounds	Pobiera związek wszystkich pól ograniczenia zawartości dla wszystkich elementów podrzędnych ContainerVisualelementu , ale nie obejmuje zawartości ContainerVisualelementu .
Dispatcher	Dispatcher Pobiera tę DispatcherObject wartość skojarzona z. (Odziedziczone po DispatcherObject)
Effect	Pobiera lub ustawia efekt mapy bitowej, który ma być stosowany do elementu ContainerVisual.
IsSealed	Pobiera wartość wskazującą, czy to wystąpienie jest obecnie zapieczętowane (tylko do odczytu). (Odziedziczone po DependencyObject)
Offset	Pobiera lub ustawia wartość ContainerVisual przesunięcia elementu z punktu odniesienia.
Opacity	Pobiera lub ustawia nieprzezroczystość ContainerVisualelementu , na podstawie wartości 0=przezroczystej, 1=nieprzezroczystej.
OpacityMask	Pobiera lub ustawia szczotkę, która określa możliwą maskę nieprzezroczystości dla .ContainerVisual
Parent	Pobiera element nadrzędny Visual dla elementu ContainerVisual.
Transform	Pobiera lub ustawia transformację, która jest stosowana do obiektu ContainerVisual.
VisualBitmapEffect	Przestarzałe. Pobiera lub ustawia BitmapEffect wartość dla elementu Visual. (Odziedziczone po Visual)
VisualBitmapEffectInput	Przestarzałe. Pobiera lub ustawia BitmapEffectInput wartość dla elementu Visual. (Odziedziczone po Visual)
VisualBitmapScalingMode	Pobiera lub ustawia wartość BitmapScalingMode dla parametru Visual. (Odziedziczone po Visual)
VisualCacheMode	Pobiera lub ustawia w pamięci podręcznej reprezentację elementu Visual. (Odziedziczone po Visual)
VisualChildrenCount	Pobiera liczbę dzieci dla obiektu ContainerVisual.
VisualClearTypeHint	Pobiera lub ustawia wartość ClearTypeHint określającą sposób renderowania typu ClearType w elemecie Visual. (Odziedziczone po Visual)
VisualClip	Pobiera lub ustawia region klipu jako VisualGeometry wartość. (Odziedziczone po Visual)
VisualEdgeMode	Pobiera lub ustawia tryb Visual krawędzi jako EdgeMode wartość. (Odziedziczone po Visual)
VisualEffect	Pobiera lub ustawia efekt mapy bitowej, który ma być stosowany do elementu Visual. (Odziedziczone po Visual)
VisualOffset	Pobiera lub ustawia wartość przesunięcia obiektu wizualizacji. (Odziedziczone po Visual)
VisualOpacity	Pobiera lub ustawia nieprzezroczystość obiektu Visual. (Odziedziczone po Visual)
VisualOpacityMask	Pobiera lub ustawia Brush wartość reprezentującą maskę nieprzezroczystości elementu Visual. (Odziedziczone po Visual)
VisualParent	Pobiera element nadrzędny drzewa wizualnego obiektu wizualizacji. (Odziedziczone po Visual)
VisualScrollableAreaClip	Pobiera lub ustawia przycięty obszar przewijania dla obiektu Visual. (Odziedziczone po Visual)
VisualTextHintingMode	Pobiera lub ustawia TextHintingMode element .Visual (Odziedziczone po Visual)
VisualTextRenderingMode	Pobiera lub ustawia TextRenderingMode element .Visual (Odziedziczone po Visual)
VisualTransform	Pobiera lub ustawia Transform wartość dla elementu Visual. (Odziedziczone po Visual)
VisualXSnappingGuidelines	Pobiera lub ustawia kolekcję wskazówek współrzędnych x (pionowo). (Odziedziczone po Visual)
VisualYSnappingGuidelines	Pobiera lub ustawia kolekcję wskazówek współrzędnych y (poziomych). (Odziedziczone po Visual)
XSnappingGuidelines	Pobiera lub ustawia wytyczne X (poziome) dla elementu ContainerVisual.
YSnappingGuidelines	Pobiera lub ustawia wytyczne Y (pionowe) dla .ContainerVisual

Metody

AddVisualChild(Visual)	Definiuje relację nadrzędny-podrzędny między dwiema wizualizacjami. (Odziedziczone po Visual)
CheckAccess()	Określa, czy wątek wywołujący ma dostęp do tego DispatcherObjectelementu . (Odziedziczone po DispatcherObject)
ClearValue(DependencyProperty)	Czyści wartość lokalną właściwości. Właściwość do wyczyszczenia jest określana przez DependencyProperty identyfikator. (Odziedziczone po DependencyObject)
ClearValue(DependencyPropertyKey)	Czyści wartość lokalną właściwości tylko do odczytu. Właściwość do wyczyszczenia jest określana przez DependencyPropertyKeyelement . (Odziedziczone po DependencyObject)
CoerceValue(DependencyProperty)	Coerce wartość określonej właściwości zależności. Jest to realizowane przez wywołanie dowolnej CoerceValueCallback funkcji określonej w metadanych właściwości dla właściwości zależności, ponieważ istnieje w wywołaniu DependencyObject. (Odziedziczone po DependencyObject)
Equals(Object)	Określa, czy podany DependencyObject element jest odpowiednikiem bieżącego DependencyObjectelementu . (Odziedziczone po DependencyObject)
FindCommonVisualAncestor(DependencyObject)	Zwraca wspólny element nadrzędny dwóch obiektów wizualnych. (Odziedziczone po Visual)
GetHashCode()	Pobiera kod skrótu dla tego pliku DependencyObject. (Odziedziczone po DependencyObject)
GetLocalValueEnumerator()	Tworzy wyspecjalizowany moduł wyliczający do określania, które właściwości zależności mają lokalnie ustawione wartości w tym DependencyObjectelemecie . (Odziedziczone po DependencyObject)
GetType()	Type Pobiera bieżące wystąpienie. (Odziedziczone po Object)
GetValue(DependencyProperty)	Zwraca bieżącą obowiązującą wartość właściwości zależności dla tego wystąpienia obiektu DependencyObject. (Odziedziczone po DependencyObject)
GetVisualChild(Int32)	Zwraca określony element podrzędny Visual dla elementu nadrzędnego ContainerVisual.
HitTest(HitTestFilterCallback, HitTestResultCallback, HitTestParameters)	Inicjuje test trafienia na obiekcie ContainerVisual przy użyciu HitTestFilterCallback obiektów i HitTestResultCallback .
HitTest(Point)	Zwraca najbardziej wizualny obiekt testu trafienia, określając element Point.
HitTestCore(GeometryHitTestParameters)	Określa, czy wartość geometryczna znajduje się w granicach obiektu wizualizacji. (Odziedziczone po Visual)
HitTestCore(PointHitTestParameters)	Określa, czy wartość współrzędnych punktu znajduje się w granicach obiektu wizualizacji. (Odziedziczone po Visual)
InvalidateProperty(DependencyProperty)	Ponownie oblicza efektywną wartość dla określonej właściwości zależności. (Odziedziczone po DependencyObject)
IsAncestorOf(DependencyObject)	Określa, czy obiekt wizualny jest obiektem nadrzędnym obiektu wizualizacji potomnej. (Odziedziczone po Visual)
IsDescendantOf(DependencyObject)	Określa, czy obiekt wizualizacji jest elementem potomnym obiektu wizualnego programu ancestor. (Odziedziczone po Visual)
MemberwiseClone()	Tworzy płytkią kopię bieżącego Objectelementu . (Odziedziczone po Object)
OnDpiChanged(DpiScale, DpiScale)	Wywoływana, gdy dpi, w której ten widok jest renderowany, zmienia się. (Odziedziczone po Visual)
OnPropertyChanged(DependencyPropertyChangedEventArgs)	Wywoływane za każdym razem, gdy obowiązująca wartość dowolnej właściwości zależności została DependencyObject zaktualizowana. Określona właściwość zależności, która uległa zmianie, jest zgłaszana w danych zdarzenia. (Odziedziczone po DependencyObject)
OnVisualChildrenChanged(DependencyObject, DependencyObject)	Wywoływana po VisualCollection zmodyfikowaniu obiektu wizualizacji. (Odziedziczone po Visual)
OnVisualParentChanged(DependencyObject)	Wywoływana po zmianie elementu nadrzędnego obiektu wizualizacji. (Odziedziczone po Visual)
PointFromScreen(Point)	Konwertuje współrzędnych Point w ekranie na Point wartość reprezentującą bieżący układ współrzędnych elementu Visual. (Odziedziczone po Visual)
PointToScreen(Point)	Konwertuje element Point , który reprezentuje bieżący układ współrzędnych współrzędnych VisualPoint na ekranie. (Odziedziczone po Visual)
ReadLocalValue(DependencyProperty)	Zwraca wartość lokalną właściwości zależności, jeśli istnieje. (Odziedziczone po DependencyObject)
RemoveVisualChild(Visual)	Usuwa relację nadrzędny-podrzędny między dwiema wizualizacjami. (Odziedziczone po Visual)
SetCurrentValue(DependencyProperty, Object)	Ustawia wartość właściwości zależności bez zmiany źródła wartości. (Odziedziczone po DependencyObject)
SetValue(DependencyProperty, Object)	Ustawia wartość lokalną właściwości zależności określonej przez jego identyfikator właściwości zależności. (Odziedziczone po DependencyObject)
SetValue(DependencyPropertyKey, Object)	Ustawia wartość lokalną właściwości zależności tylko do odczytu określona przez DependencyPropertyKey identyfikator właściwości zależności. (Odziedziczone po DependencyObject)
ShouldSerializeProperty(DependencyProperty)	Zwraca wartość wskazującą, czy procesy serializacji powinny serializować wartość podanej właściwości zależności. (Odziedziczone po DependencyObject)
ToString()	Zwraca ciąg reprezentujący bieżący obiekt. (Odziedziczone po Object)
TransformToAncestor(Visual)	Zwraca transformację, która może służyć do przekształcania współrzędnych z obiektu wizualnego na Visual określony Visual element nadrzędny. (Odziedziczone po Visual)
TransformToAncestor(Visual3D)	Zwraca transformację, która może służyć do przekształcania współrzędnych z obiektu wizualnego na Visual określony Visual3D element nadrzędny. (Odziedziczone po Visual)
TransformToDescendant(Visual)	Zwraca przekształcenie, które może służyć do przekształcania współrzędnych z Visual elementu podrzędnego do określonego obiektu wizualnego. (Odziedziczone po Visual)
TransformToVisual(Visual)	Zwraca przekształcenie, które może służyć do przekształcania współrzędnych z Visual obiektu do określonego obiektu wizualizacji. (Odziedziczone po Visual)
VerifyAccess()	Wymusza, że wątek wywołujący ma dostęp do tego DispatcherObjectelementu . (Odziedziczone po DispatcherObject)