ContainerVisual Classe

Définition

Espace de noms:

System.Windows.Media

Assembly:

PresentationCore.dll

Gère une collection d’objets Visual.

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

Héritage

Object

DispatcherObject

DependencyObject

Visual

ContainerVisual

Dérivé

System.Windows.Media.DrawingVisual

System.Windows.Media.HostVisual

Exemples

L’exemple suivant montre comment créer un ContainerVisual objet qui est utilisé comme parent pour deux DrawingVisual objets. Les objets ajoutés à l’objet doivent être ajoutés dans l’ordre ContainerVisual z inverse (de bas en haut) pour s’assurer qu’ils sont rendus dans l’ordre de dessin correct. Pour que l’arborescence visuelle soit énumérée correctement, l’exemple fournit des implémentations substituées de la méthode et VisualChildrenCount de la GetVisualChild propriété.

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

Remarques

La ContainerVisual classe est utilisée comme conteneur pour une collection d’objets Visual . La DrawingVisual classe dérive de la ContainerVisual classe, de sorte que la DrawingVisual classe peut également contenir une collection d’objets visuels.

Constructeurs

ContainerVisual()

Crée une instance de la classe ContainerVisual.

Propriétés

BitmapEffect	Obsolète. Obtient ou définit une valeur BitmapEffect pour le ContainerVisual.
BitmapEffectInput	Obsolète. Obtient ou définit une valeur BitmapEffectInput pour le ContainerVisual.
CacheMode	Obtient ou définit la représentation mise en cache de ContainerVisual.
Children	Obtient la collection enfant du ContainerVisual.
Clip	Obtient ou définit la zone de découpage du ContainerVisual.
ContentBounds	Obtient le cadre englobant pour le contenu du ContainerVisual.
DependencyObjectType	Obtient le DependencyObjectType qui encapsule le type CLR de cette instance. (Hérité de DependencyObject)
DescendantBounds	Obtient l'union de tous les cadres englobants de contenu de tous les descendant du ContainerVisual, mais pas le contenu du ContainerVisual.
Dispatcher	Obtient le Dispatcher associé à DispatcherObject. (Hérité de DispatcherObject)
Effect	Obtient ou définit l'effet bitmap à appliquer à ContainerVisual.
IsSealed	Récupère une valeur qui indique si cette instance est actuellement sealed (en lecture seule). (Hérité de DependencyObject)
Offset	Obtient ou définit la valeur offset du ContainerVisual à partir de son point de référence.
Opacity	Obtient ou définit l'opacité du ContainerVisual, selon 0=transparent, 1=opaque.
OpacityMask	Obtient ou définit un pinceau qui spécifie un masque d'opacité possible pour le ContainerVisual.
Parent	Obtient le Visual parent pour le ContainerVisual.
Transform	Obtient ou définit la transformation qui est appliquée au ContainerVisual.
VisualBitmapEffect	Obsolète. Obtient ou définit la valeur BitmapEffect du Visual. (Hérité de Visual)
VisualBitmapEffectInput	Obsolète. Obtient ou définit la valeur BitmapEffectInput du Visual. (Hérité de Visual)
VisualBitmapScalingMode	Obtient ou définit BitmapScalingMode pour Visual. (Hérité de Visual)
VisualCacheMode	Obtient ou définit la représentation mise en cache de Visual. (Hérité de Visual)
VisualChildrenCount	Obtient le nombre d’enfants pour le ContainerVisual.
VisualClearTypeHint	Obtient ou définit le ClearTypeHint qui détermine la façon dont ClearType est rendu dans Visual. (Hérité de Visual)
VisualClip	Obtient ou définit la zone de découpage du Visual en tant que valeur Geometry. (Hérité de Visual)
VisualEdgeMode	Obtient ou définit le mode de bord du Visual en tant que valeur EdgeMode. (Hérité de Visual)
VisualEffect	Obtient ou définit l'effet bitmap à appliquer à Visual. (Hérité de Visual)
VisualOffset	Obtient ou définit la valeur de décalage de l'objet visuel. (Hérité de Visual)
VisualOpacity	Obtient ou définit l'opacité du Visual. (Hérité de Visual)
VisualOpacityMask	Obtient ou définit la valeur Brush qui représente le masque d'opacité du Visual. (Hérité de Visual)
VisualParent	Obtient le parent d'arborescence d'éléments visuels de l'objet visuel. (Hérité de Visual)
VisualScrollableAreaClip	Obtient ou définit une zone à défilement découpée pour Visual. (Hérité de Visual)
VisualTextHintingMode	Obtient ou définit le TextHintingMode de Visual. (Hérité de Visual)
VisualTextRenderingMode	Obtient ou définit le TextRenderingMode de Visual. (Hérité de Visual)
VisualTransform	Obtient ou définit la valeur Transform du Visual. (Hérité de Visual)
VisualXSnappingGuidelines	Obtient ou définit la collection d’indications de coordonnée X (verticale). (Hérité de Visual)
VisualYSnappingGuidelines	Obtient ou définit la collection d’indications de coordonnée y (horizontale). (Hérité de Visual)
XSnappingGuidelines	Obtient ou définit l’indication X (horizontale) pour ContainerVisual.
YSnappingGuidelines	Obtient ou définit l’indication Y (verticale) pour ContainerVisual.

Méthodes

AddVisualChild(Visual)	Définit la relation parent-enfant entre deux objets visuels. (Hérité de Visual)
CheckAccess()	Détermine si le thread appelant a accès à ce DispatcherObject. (Hérité de DispatcherObject)
ClearValue(DependencyProperty)	Efface la valeur locale d’une propriété. La propriété à effacer est spécifiée par un identificateur DependencyProperty. (Hérité de DependencyObject)
ClearValue(DependencyPropertyKey)	Efface la valeur locale d’une propriété en lecture seule. La propriété à effacer est spécifiée par DependencyPropertyKey. (Hérité de DependencyObject)
CoerceValue(DependencyProperty)	Convertit la valeur de la propriété de dépendance spécifiée. Pour cela, on appelle toute fonction CoerceValueCallback spécifiée dans les métadonnées de propriété pour la propriété de dépendance telle qu’elle existe sur le DependencyObject appelant. (Hérité de DependencyObject)
Equals(Object)	Détermine si un DependencyObject fourni est équivalent au DependencyObject réel. (Hérité de DependencyObject)
FindCommonVisualAncestor(DependencyObject)	Retourne l'ancêtre commun de deux objets visuels. (Hérité de Visual)
GetHashCode()	Obtient un code de hachage pour ce DependencyObject. (Hérité de DependencyObject)
GetLocalValueEnumerator()	Crée un énumérateur spécialisé pour déterminer quelles propriétés de dépendance ont des valeurs définies localement sur ce DependencyObject. (Hérité de DependencyObject)
GetType()	Obtient le Type de l'instance actuelle. (Hérité de Object)
GetValue(DependencyProperty)	Retourne la valeur effective actuelle d’une propriété de dépendance sur cette instance d’un DependencyObject. (Hérité de DependencyObject)
GetVisualChild(Int32)	Retourne un Visual enfant spécifié pour le ContainerVisual parent.
HitTest(HitTestFilterCallback, HitTestResultCallback, HitTestParameters)	Exécute un test de positionnement sur ContainerVisual à l’aide des objets HitTestFilterCallback et HitTestResultCallback.
HitTest(Point)	Retourne l’objet visuel supérieur d’un test de positionnement en spécifiant un Point.
HitTestCore(GeometryHitTestParameters)	Détermine si la valeur d'une géométrie s'inscrit dans les limites de l'objet visuel. (Hérité de Visual)
HitTestCore(PointHitTestParameters)	Détermine si la valeur de coordonnée d'un point s'inscrit dans les limites de l'objet visuel. (Hérité de Visual)
InvalidateProperty(DependencyProperty)	Réévalue la valeur effective de la propriété de dépendance spécifiée. (Hérité de DependencyObject)
IsAncestorOf(DependencyObject)	Détermine si l'objet visuel est un ancêtre de l'objet visuel descendant. (Hérité de Visual)
IsDescendantOf(DependencyObject)	Détermine si l'objet visuel est un descendant de l'objet visuel ancêtre. (Hérité de Visual)
MemberwiseClone()	Crée une copie superficielle du Object actuel. (Hérité de Object)
OnDpiChanged(DpiScale, DpiScale)	Appelé en cas de modification des ppp d’affichage de cette Vue. (Hérité de Visual)
OnPropertyChanged(DependencyPropertyChangedEventArgs)	Méthode appelée chaque fois que la valeur effective d’une propriété de dépendance sur ce DependencyObject a été mise à jour. La propriété de dépendance spécifique qui a changé est signalée dans les données d’événement. (Hérité de DependencyObject)
OnVisualChildrenChanged(DependencyObject, DependencyObject)	Appelé lorsque le VisualCollection de l'objet visuel est modifié. (Hérité de Visual)
OnVisualParentChanged(DependencyObject)	Appelé lorsque le parent de l'objet visuel est modifié. (Hérité de Visual)
PointFromScreen(Point)	Convertit un Point en coordonnées d'écran en Point qui représente le système de coordonnées actuel du Visual. (Hérité de Visual)
PointToScreen(Point)	Convertit un Point qui représente le système de coordonnées actuel du Visual en Point en coordonnées d'écran. (Hérité de Visual)
ReadLocalValue(DependencyProperty)	Retourne la valeur locale d’une propriété de dépendance, si elle existe. (Hérité de DependencyObject)
RemoveVisualChild(Visual)	Supprime la relation parent-enfant entre deux objets visuels. (Hérité de Visual)
SetCurrentValue(DependencyProperty, Object)	Définit la valeur d’une propriété de dépendance sans modifier sa valeur source. (Hérité de DependencyObject)
SetValue(DependencyProperty, Object)	Définit la valeur locale d’une propriété de dépendance, spécifiée par son identificateur de propriété de dépendance. (Hérité de DependencyObject)
SetValue(DependencyPropertyKey, Object)	Définit la valeur locale d’une propriété de dépendance en lecture seule, spécifiée par l’identificateur DependencyPropertyKey de la propriété de dépendance. (Hérité de DependencyObject)
ShouldSerializeProperty(DependencyProperty)	Retourne une valeur qui indique si les processus de sérialisation doivent sérialiser la valeur de la propriété de dépendance fournie. (Hérité de DependencyObject)
ToString()	Retourne une chaîne qui représente l'objet actuel. (Hérité de Object)
TransformToAncestor(Visual)	Retourne une transformation qui peut être utilisée pour transformer les coordonnées du Visual dans l'ancêtre Visual spécifié de l'objet visuel. (Hérité de Visual)
TransformToAncestor(Visual3D)	Retourne une transformation qui peut être utilisée pour transformer les coordonnées du Visual dans l'ancêtre Visual3D spécifié de l'objet visuel. (Hérité de Visual)
TransformToDescendant(Visual)	Retourne une transformation qui peut être utilisée pour transformer les coordonnées du Visual dans le descendant spécifié de l'objet visuel. (Hérité de Visual)
TransformToVisual(Visual)	Retourne une transformation qui peut être utilisée pour transformer les coordonnées du Visual dans l'objet visuel spécifié. (Hérité de Visual)
VerifyAccess()	Garantit que le thread appelant a accès à DispatcherObject. (Hérité de DispatcherObject)