ContainerVisual Klass

Definition

Namnområde:
System.Windows.Media
Sammansättning:
PresentationCore.dll

Hanterar en samling 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
Arv
Object
DispatcherObject
DependencyObject
Visual
ContainerVisual
Härledda

Exempel

I följande exempel visas hur du skapar ett ContainerVisual objekt som används som överordnat objekt för två DrawingVisual objekt. Objekt som läggs till i ContainerVisual objektet måste läggas till i omvänd z-ordning (nedifrån och upp) för att säkerställa att de återges i rätt ritningsordning. För att det visuella trädet ska räknas upp korrekt tillhandahåller exemplet övergripande implementeringar av GetVisualChild metoden och VisualChildrenCount egenskapen.

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

Kommentarer

Klassen ContainerVisual används som en container för en samling Visual objekt. Klassen DrawingVisual härleds från ContainerVisual klassen, så att DrawingVisual klassen också kan innehålla en samling visuella objekt.

Konstruktorer

Name Description
ContainerVisual()

Skapar en ny instans av ContainerVisual klassen.

Egenskaper

Name Description
BitmapEffect
Föråldrad.
Föråldrad.

Hämtar eller anger ett BitmapEffect värde för ContainerVisual.
BitmapEffectInput
Föråldrad.
Föråldrad.

Hämtar eller anger ett BitmapEffectInput värde för ContainerVisual.
CacheMode

Hämtar eller anger en cachelagrad representation av ContainerVisual.
Children

Hämtar den underordnade samlingen av ContainerVisual.
Clip

Hämtar eller anger urklippsregionen för ContainerVisual.
ContentBounds

Hämtar avgränsningsrutan för innehållet i ContainerVisual.
DependencyObjectType

DependencyObjectType Hämtar som omsluter CLR-typen för den här instansen.

(Ärvd från DependencyObject)
DescendantBounds

Hämtar en union av alla innehållsgränsrutor för alla ContainerVisualunderordnade i , men inte innehållet i ContainerVisual.
Dispatcher

Hämtar det Dispatcher som DispatcherObject är associerat med.

(Ärvd från DispatcherObject)
Effect

Hämtar eller anger bitmappseffekten som ska tillämpas på ContainerVisual.
IsSealed

Hämtar ett värde som anger om den här instansen för närvarande är förseglad (skrivskyddad).

(Ärvd från DependencyObject)
Offset

Hämtar eller anger förskjutningsvärdet för ContainerVisual från dess referenspunkt.
Opacity

Hämtar eller anger opaciteten för ContainerVisual, baserat på 0=transparent, 1=ogenomskinlig.
OpacityMask

Hämtar eller anger en pensel som anger en möjlig ogenomskinlighetsmask för ContainerVisual.
Parent

Hämtar överordnad VisualContainerVisualför .
Transform

Hämtar eller anger den transformering som tillämpas på ContainerVisual.
VisualBitmapEffect
Föråldrad.
Föråldrad.

Hämtar eller anger BitmapEffect värdet för Visual.

(Ärvd från Visual)
VisualBitmapEffectInput
Föråldrad.
Föråldrad.

Hämtar eller anger BitmapEffectInput värdet för Visual.

(Ärvd från Visual)
VisualBitmapScalingMode

Hämtar eller anger BitmapScalingMode för Visual.

(Ärvd från Visual)
VisualCacheMode

Hämtar eller anger en cachelagrad representation av Visual.

(Ärvd från Visual)
VisualChildrenCount

Hämtar antalet underordnade för ContainerVisual.
VisualClearTypeHint

Hämtar eller anger ClearTypeHint som avgör hur ClearType återges i Visual.

(Ärvd från Visual)
VisualClip

Hämtar eller anger klippområdet för Visual som ett Geometry värde.

(Ärvd från Visual)
VisualEdgeMode

Hämtar eller anger kantläget för Visual som ett EdgeMode värde.

(Ärvd från Visual)
VisualEffect

Hämtar eller anger bitmappseffekten som ska tillämpas på Visual.

(Ärvd från Visual)
VisualOffset

Hämtar eller anger förskjutningsvärdet för det visuella objektet.

(Ärvd från Visual)
VisualOpacity

Hämtar eller anger opaciteten för Visual.

(Ärvd från Visual)
VisualOpacityMask

Hämtar eller anger värdet Brush som representerar opacitetsmasken för Visual.

(Ärvd från Visual)
VisualParent

Hämtar det visuella trädets överordnade objekt.

(Ärvd från Visual)
VisualScrollableAreaClip

Hämtar eller anger ett klippt rullningsbart område för Visual.

(Ärvd från Visual)
VisualTextHintingMode

Hämtar eller ställer in TextHintingMode i Visual.

(Ärvd från Visual)
VisualTextRenderingMode

Hämtar eller ställer in TextRenderingMode i Visual.

(Ärvd från Visual)
VisualTransform

Hämtar eller anger Transform värdet för Visual.

(Ärvd från Visual)
VisualXSnappingGuidelines

Hämtar eller anger riktlinjesamlingen x-koordinat (lodrät).

(Ärvd från Visual)
VisualYSnappingGuidelines

Hämtar eller anger y-koordinatsamlingen (vågrät) riktlinje.

(Ärvd från Visual)
XSnappingGuidelines

Hämtar eller anger X-riktlinjen (vågrätt) för ContainerVisual.
YSnappingGuidelines

Hämtar eller anger Y-riktlinjen (lodrät) för ContainerVisual.

Metoder

Name Description
AddVisualChild(Visual)

Definierar relationen mellan överordnad och underordnad mellan två visuella objekt.

(Ärvd från Visual)
CheckAccess()

Avgör om den anropande tråden har åtkomst till den här DispatcherObject.

(Ärvd från DispatcherObject)
ClearValue(DependencyProperty)

Rensar det lokala värdet för en egenskap. Egenskapen som ska rensas anges av en DependencyProperty identifierare.

(Ärvd från DependencyObject)
ClearValue(DependencyPropertyKey)

Rensar det lokala värdet för en skrivskyddad egenskap. Egenskapen som ska rensas anges av en DependencyPropertyKey.

(Ärvd från DependencyObject)
CoerceValue(DependencyProperty)

Tvingar fram värdet för den angivna beroendeegenskapen. Detta uppnås genom att anropa alla CoerceValueCallback funktioner som anges i egenskapsmetadata för beroendeegenskapen eftersom den finns på anropet DependencyObject.

(Ärvd från DependencyObject)
Equals(Object)

Avgör om en angivet DependencyObject motsvarar den aktuella DependencyObject.

(Ärvd från DependencyObject)
FindCommonVisualAncestor(DependencyObject)

Returnerar den gemensamma överordnad för två visuella objekt.

(Ärvd från Visual)
GetHashCode()

Hämtar en hash-kod för den här DependencyObject.

(Ärvd från DependencyObject)
GetLocalValueEnumerator()

Skapar en specialiserad uppräknare för att avgöra vilka beroendeegenskaper som har lokalt angivna värden för den här DependencyObject.

(Ärvd från DependencyObject)
GetType()

Hämtar den aktuella instansen Type .

(Ärvd från Object)
GetValue(DependencyProperty)

Returnerar det aktuella effektiva värdet för en beroendeegenskap för den här instansen av en DependencyObject.

(Ärvd från DependencyObject)
GetVisualChild(Int32)

Returnerar ett angivet underordnat Visual objekt för den överordnade ContainerVisual.
HitTest(HitTestFilterCallback, HitTestResultCallback, HitTestParameters)

Initierar ett träfftest på ContainerVisual med hjälp av objekten HitTestFilterCallback och HitTestResultCallback .
HitTest(Point)

Returnerar det mest visuella objektet i ett träfftest genom att ange en Point.
HitTestCore(GeometryHitTestParameters)

Avgör om ett geometrivärde ligger inom gränserna för det visuella objektet.

(Ärvd från Visual)
HitTestCore(PointHitTestParameters)

Avgör om ett punktkoordinatvärde ligger inom gränserna för det visuella objektet.

(Ärvd från Visual)
InvalidateProperty(DependencyProperty)

Utvärderar det effektiva värdet för den angivna beroendeegenskapen igen.

(Ärvd från DependencyObject)
IsAncestorOf(DependencyObject)

Avgör om det visuella objektet är en överordnad objekt för det underordnade visuella objektet.

(Ärvd från Visual)
IsDescendantOf(DependencyObject)

Avgör om det visuella objektet är underordnat det överordnade visuella objektet.

(Ärvd från Visual)
MemberwiseClone()

Skapar en ytlig kopia av den aktuella Object.

(Ärvd från Object)
OnDpiChanged(DpiScale, DpiScale)

Anropas när DPI:et där den här vyn återges ändras.

(Ärvd från Visual)
OnPropertyChanged(DependencyPropertyChangedEventArgs)

Anropas när det effektiva värdet för någon beroendeegenskap DependencyObject har uppdaterats. Den specifika beroendeegenskap som ändrades rapporteras i händelsedata.

(Ärvd från DependencyObject)
OnVisualChildrenChanged(DependencyObject, DependencyObject)

Anropas när objektet VisualCollection för det visuella objektet ändras.

(Ärvd från Visual)
OnVisualParentChanged(DependencyObject)

Anropas när det överordnade objektet för det visuella objektet ändras.

(Ärvd från Visual)
PointFromScreen(Point)

Konverterar en Point i-skärmkoordinat till en Point som representerar det aktuella koordinatsystemet för Visual.

(Ärvd från Visual)
PointToScreen(Point)

Konverterar ett Point som representerar det aktuella koordinatsystemet för Visual till en Point i skärmkoordinater.

(Ärvd från Visual)
ReadLocalValue(DependencyProperty)

Returnerar det lokala värdet för en beroendeegenskap, om den finns.

(Ärvd från DependencyObject)
RemoveVisualChild(Visual)

Tar bort relationen mellan överordnad och underordnad mellan två visuella objekt.

(Ärvd från Visual)
SetCurrentValue(DependencyProperty, Object)

Anger värdet för en beroendeegenskap utan att ändra dess värdekälla.

(Ärvd från DependencyObject)
SetValue(DependencyProperty, Object)

Anger det lokala värdet för en beroendeegenskap som anges av dess beroendeegenskapsidentifierare.

(Ärvd från DependencyObject)
SetValue(DependencyPropertyKey, Object)

Anger det lokala värdet för en skrivskyddad beroendeegenskap som anges av identifieraren DependencyPropertyKey för beroendeegenskapen.

(Ärvd från DependencyObject)
ShouldSerializeProperty(DependencyProperty)

Returnerar ett värde som anger om serialiseringsprocesser ska serialisera värdet för den angivna beroendeegenskapen.

(Ärvd från DependencyObject)
ToString()

Returnerar en sträng som representerar det aktuella objektet.

(Ärvd från Object)
TransformToAncestor(Visual)

Returnerar en transformering som kan användas för att transformera koordinater från Visual till angiven överordnad Visual för det visuella objektet.

(Ärvd från Visual)
TransformToAncestor(Visual3D)

Returnerar en transformering som kan användas för att transformera koordinater från Visual till angiven överordnad Visual3D för det visuella objektet.

(Ärvd från Visual)
TransformToDescendant(Visual)

Returnerar en transformering som kan användas för att transformera koordinater från Visual till det angivna visuella objektets underordnade objekt.

(Ärvd från Visual)
TransformToVisual(Visual)

Returnerar en transformering som kan användas för att transformera koordinater från Visual till det angivna visuella objektet.

(Ärvd från Visual)
VerifyAccess()

Framtvingar att den anropande tråden har åtkomst till den här DispatcherObject.

(Ärvd från DispatcherObject)

Gäller för