Udostępnij za pośrednictwem


ContainerVisual Klasa

Definicja

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
Pochodne

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.
Przestarzałe.

Pobiera lub ustawia BitmapEffect wartość dla elementu ContainerVisual.

BitmapEffectInput
Przestarzałe.
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.
Przestarzałe.

Pobiera lub ustawia BitmapEffect wartość dla elementu Visual.

(Odziedziczone po Visual)
VisualBitmapEffectInput
Przestarzałe.
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)

Dotyczy