Partager via


ContainerVisual Classe

Définition

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
Dérivé

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.
Obsolète.

Obtient ou définit une valeur BitmapEffect pour le ContainerVisual.

BitmapEffectInput
Obsolète.
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.
Obsolète.

Obtient ou définit la valeur BitmapEffect du Visual.

(Hérité de Visual)
VisualBitmapEffectInput
Obsolète.
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)

S’applique à