ContainerVisual Třída

Definice

Obor názvů:

System.Windows.Media

Sestavení:

PresentationCore.dll

Spravuje kolekci Visual objektů.

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

Dědičnost

Object

DispatcherObject

DependencyObject

Visual

ContainerVisual

Odvozené

System.Windows.Media.DrawingVisual

System.Windows.Media.HostVisual

Příklady

Následující příklad ukazuje, jak vytvořit ContainerVisual objekt, který se použije jako nadřazený objekt pro dva DrawingVisual objekty. Objekty přidané do objektu ContainerVisual musí být přidány v obráceném pořadí vykreslování (zdola nahoru), aby se zajistilo, že se vykreslují ve správném pořadí kreslení. Aby vizuální strom byl správně výčtu, příklad poskytuje přepsání GetVisualChild implementace metody a VisualChildrenCount vlastnosti.

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

Poznámky

Třída se ContainerVisual používá jako kontejner pro kolekci Visual objektů. Třída DrawingVisual je odvozena z ContainerVisual třídy , tak, že DrawingVisual třída může také obsahovat kolekci vizuálních objektů.

Konstruktory

ContainerVisual()

Vytvoří novou instanci třídy ContainerVisual.

Vlastnosti

BitmapEffect	Zastaralé. Získá nebo nastaví BitmapEffect hodnotu pro ContainerVisual.
BitmapEffectInput	Zastaralé. Získá nebo nastaví BitmapEffectInput hodnotu pro ContainerVisual.
CacheMode	Získá nebo nastaví reprezentaci ContainerVisualv mezipaměti .
Children	Získá podřízenou kolekci objektu ContainerVisual.
Clip	Získá nebo nastaví oblast oříznutí objektu ContainerVisual.
ContentBounds	Získá ohraničující rámeček pro obsah objektu ContainerVisual.
DependencyObjectType	Získá, DependencyObjectType který zabalí typ CLR této instance. (Zděděno od DependencyObject)
DescendantBounds	Získá sjednocení všech rámečků ohraničující obsah pro všechny potomky objektu ContainerVisual, ale nezahrnuje obsah objektu ContainerVisual.
Dispatcher	Získá to DispatcherDispatcherObject je přidružena k. (Zděděno od DispatcherObject)
Effect	Získá nebo nastaví rastrový efekt pro použití na ContainerVisual.
IsSealed	Získá hodnotu, která označuje, zda je tato instance právě zapečetěna (jen pro čtení). (Zděděno od DependencyObject)
Offset	Získá nebo nastaví hodnotu posunu z jeho referenčního ContainerVisual bodu.
Opacity	Získá nebo nastaví neprůhlednost objektu ContainerVisualna základě hodnot 0=průhledné, 1=neprůhledné.
OpacityMask	Získá nebo nastaví štětec, který určuje možnou masku neprůhlednosti pro ContainerVisual.
Parent	Získá nadřazený Visual objekt pro ContainerVisual.
Transform	Získá nebo nastaví transformaci, která se použije na ContainerVisual.
VisualBitmapEffect	Zastaralé. Získá nebo nastaví BitmapEffect hodnotu pro Visual. (Zděděno od Visual)
VisualBitmapEffectInput	Zastaralé. Získá nebo nastaví BitmapEffectInput hodnotu pro Visual. (Zděděno od Visual)
VisualBitmapScalingMode	Získá nebo nastaví pro BitmapScalingModeVisual. (Zděděno od Visual)
VisualCacheMode	Získá nebo nastaví reprezentaci Visualv mezipaměti . (Zděděno od Visual)
VisualChildrenCount	Získá počet podřízených položek pro ContainerVisual.
VisualClearTypeHint	Získá nebo nastaví , ClearTypeHint který určuje, jak ClearType je vykreslena v Visual. (Zděděno od Visual)
VisualClip	Získá nebo nastaví oblast klipu Visual jako Geometry hodnotu. (Zděděno od Visual)
VisualEdgeMode	Získá nebo nastaví hraniční režim Visual jako EdgeMode hodnotu. (Zděděno od Visual)
VisualEffect	Získá nebo nastaví rastrový efekt pro použití na Visual. (Zděděno od Visual)
VisualOffset	Získá nebo nastaví hodnotu posunu objektu vizuálu. (Zděděno od Visual)
VisualOpacity	Získá nebo nastaví neprůhlednost objektu Visual. (Zděděno od Visual)
VisualOpacityMask	Získá nebo nastaví Brush hodnotu, která představuje masku neprůhlednosti objektu Visual. (Zděděno od Visual)
VisualParent	Získá nadřazený vizuální strom objektu vizuálu. (Zděděno od Visual)
VisualScrollableAreaClip	Získá nebo nastaví oříznutou posouvatelnou oblast pro Visual. (Zděděno od Visual)
VisualTextHintingMode	Získá nebo nastaví TextHintingMode z Visual. (Zděděno od Visual)
VisualTextRenderingMode	Získá nebo nastaví TextRenderingMode z Visual. (Zděděno od Visual)
VisualTransform	Získá nebo nastaví Transform hodnotu pro Visual. (Zděděno od Visual)
VisualXSnappingGuidelines	Získá nebo nastaví x-souřadnice (svislé) vodítka kolekce. (Zděděno od Visual)
VisualYSnappingGuidelines	Získá nebo nastaví kolekci vodítek souřadnice y (vodorovné). (Zděděno od Visual)
XSnappingGuidelines	Získá nebo nastaví vodítko X (vodorovné ContainerVisual) pro .
YSnappingGuidelines	Získá nebo nastaví vodítko Y (svisle) pro ContainerVisual.

Metody

AddVisualChild(Visual)	Definuje vztah nadřazenosti a podřízenosti mezi dvěma vizuály. (Zděděno od Visual)
CheckAccess()	Určuje, zda volající vlákno má přístup k tomuto DispatcherObject. (Zděděno od DispatcherObject)
ClearValue(DependencyProperty)	Vymaže místní hodnotu vlastnosti. Vlastnost, která má být vymazána, je určena identifikátorem DependencyProperty . (Zděděno od DependencyObject)
ClearValue(DependencyPropertyKey)	Vymaže místní hodnotu vlastnosti jen pro čtení. Vlastnost, která se má vymazat, je určena parametrem DependencyPropertyKey. (Zděděno od DependencyObject)
CoerceValue(DependencyProperty)	Převede hodnotu zadané vlastnosti závislosti. Toho se dosáhne vyvoláním jakékoli CoerceValueCallback funkce zadané v metadatech vlastnosti závislosti, protože existuje ve volajícím DependencyObjectobjektu . (Zděděno od DependencyObject)
Equals(Object)	Určuje, zda zadaný DependencyObject je ekvivalentní k aktuálnímu DependencyObject. (Zděděno od DependencyObject)
FindCommonVisualAncestor(DependencyObject)	Vrátí společný nadřazený objekt dvou vizuálních objektů. (Zděděno od Visual)
GetHashCode()	Získá hash kód pro tento DependencyObject. (Zděděno od DependencyObject)
GetLocalValueEnumerator()	Vytvoří specializovaný enumerátor pro určení vlastností závislostí, které mají místně nastavené hodnoty v tomto DependencyObjectobjektu . (Zděděno od DependencyObject)
GetType()	Type Získá z aktuální instance. (Zděděno od Object)
GetValue(DependencyProperty)	Vrátí aktuální efektivní hodnotu vlastnosti závislosti na této instanci objektu DependencyObject. (Zděděno od DependencyObject)
GetVisualChild(Int32)	Vrátí zadanou podřízenou Visual položku nadřazeného ContainerVisualobjektu .
HitTest(HitTestFilterCallback, HitTestResultCallback, HitTestParameters)	Inicializuje test přístupů na objektu ContainerVisual pomocí HitTestFilterCallback objektů a HitTestResultCallback .
HitTest(Point)	Vrátí nejvýraznější vizuální objekt testu přístupů zadáním Point.
HitTestCore(GeometryHitTestParameters)	Určuje, zda je hodnota geometrie v mezích vizuálního objektu. (Zděděno od Visual)
HitTestCore(PointHitTestParameters)	Určuje, zda se hodnota souřadnice bodu nachází v mezích objektu vizuálu. (Zděděno od Visual)
InvalidateProperty(DependencyProperty)	Znovu vyhodnotí efektivní hodnotu pro zadanou vlastnost závislosti. (Zděděno od DependencyObject)
IsAncestorOf(DependencyObject)	Určuje, zda je objekt vizuálu nadřazený následníkovi objektu vizuálu. (Zděděno od Visual)
IsDescendantOf(DependencyObject)	Určuje, zda vizuální objekt je potomkem nadřazeného objektu vizuálu. (Zděděno od Visual)
MemberwiseClone()	Vytvoří mělkou kopii aktuálního Objectsouboru . (Zděděno od Object)
OnDpiChanged(DpiScale, DpiScale)	Volá se, když se změní DPI, při kterém je toto zobrazení vykresleno. (Zděděno od Visual)
OnPropertyChanged(DependencyPropertyChangedEventArgs)	Vyvolá se vždy, když byla aktualizována efektivní hodnota jakékoli vlastnosti závislosti na této DependencyObject vlastnosti. Konkrétní změněná vlastnost závislosti je uvedena v datech události. (Zděděno od DependencyObject)
OnVisualChildrenChanged(DependencyObject, DependencyObject)	Volána při VisualCollection změně objektu vizuálu. (Zděděno od Visual)
OnVisualParentChanged(DependencyObject)	Volána při změně nadřazeného objektu vizuálu. (Zděděno od Visual)
PointFromScreen(Point)	Převede Point souřadnice Point na obrazovce, který představuje aktuální systém Visualsouřadnic . (Zděděno od Visual)
PointToScreen(Point)	Point Převede objekt, který představuje aktuální souřadnicový systém objektu VisualPoint na souřadnice na obrazovce. (Zděděno od Visual)
ReadLocalValue(DependencyProperty)	Vrátí místní hodnotu vlastnosti závislosti, pokud existuje. (Zděděno od DependencyObject)
RemoveVisualChild(Visual)	Odebere vztah nadřazenosti a podřízenosti mezi dvěma vizuály. (Zděděno od Visual)
SetCurrentValue(DependencyProperty, Object)	Nastaví hodnotu vlastnosti závislosti beze změny jejího zdroje hodnoty. (Zděděno od DependencyObject)
SetValue(DependencyProperty, Object)	Nastaví místní hodnotu vlastnosti závislosti určenou identifikátorem vlastnosti závislosti. (Zděděno od DependencyObject)
SetValue(DependencyPropertyKey, Object)	Nastaví místní hodnotu vlastnosti závislosti jen pro čtení určenou DependencyPropertyKey identifikátorem vlastnosti závislosti. (Zděděno od DependencyObject)
ShouldSerializeProperty(DependencyProperty)	Vrátí hodnotu, která označuje, zda serializační procesy mají serializovat hodnotu pro zadanou vlastnost závislosti. (Zděděno od DependencyObject)
ToString()	Vrátí řetězec, který představuje aktuální objekt. (Zděděno od Object)
TransformToAncestor(Visual)	Vrátí transformaci, kterou lze použít k transformaci souřadnic z objektu Visual do zadaného Visual nadřazeného objektu vizuálu. (Zděděno od Visual)
TransformToAncestor(Visual3D)	Vrátí transformaci, kterou lze použít k transformaci souřadnic z objektu Visual do zadaného Visual3D nadřazeného objektu vizuálu. (Zděděno od Visual)
TransformToDescendant(Visual)	Vrátí transformaci, která se dá použít k transformaci souřadnic z objektu Visual na potomka zadaného objektu vizuálu. (Zděděno od Visual)
TransformToVisual(Visual)	Vrátí transformaci, která se dá použít k transformaci souřadnic z objektu Visual do zadaného objektu vizuálu. (Zděděno od Visual)
VerifyAccess()	Vynucuje, že volající vlákno má přístup k tomuto DispatcherObject. (Zděděno od DispatcherObject)