Windows Dev Center

Cet article a fait l'objet d'une traduction automatique. Déplacez votre pointeur sur les phrases de l'article pour voir la version originale de ce texte. Informations supplémentaires.
Traduction
Source
Informations
Le sujet que vous avez demandé est indiqué ci-dessous. Toutefois, ce sujet ne figure pas dans la bibliothèque.

ContainerVisual, classe

Gère une collection d'objets Visual.

Espace de noms :  System.Windows.Media
Assembly :  PresentationCore (dans PresentationCore.dll)
XMLNS pour XAML : http://schemas.microsoft.com/winfx/2006/xaml/presentation, http://schemas.microsoft.com/netfx/2007/xaml/presentation

public class ContainerVisual : Visual

Le type ContainerVisual expose les membres suivants.

  NomDescription
Méthode publiqueContainerVisualCrée une instance de la classe ContainerVisual.
Début

  NomDescription
Propriété publiqueBitmapEffect Obsolète. Obtient ou définit une valeur BitmapEffect pour le ContainerVisual.
Propriété publiqueBitmapEffectInput Obsolète. Obtient ou définit une valeur BitmapEffectInput pour le ContainerVisual.
Propriété publiqueCacheModeObtient ou définit une représentation mise en cache de ContainerVisual.
Propriété publiqueChildrenObtient la collection enfant du ContainerVisual.
Propriété publiqueClipObtient ou définit la zone de découpage du ContainerVisual.
Propriété publiqueContentBoundsReçoit le cadre englobant pour le contenu du ContainerVisual.
Propriété publiqueDependencyObjectTypeObtient le DependencyObjectType qui encapsule le type CLR de cette instance.  (Hérité de DependencyObject.)
Propriété publiqueDescendantBoundsObtient l'union de tous les cadres englobants de contenu de tous les descendant du ContainerVisual, mais pas le contenu du ContainerVisual.
Propriété publiqueDispatcherObtient le Dispatcher associé à DispatcherObject. (Hérité de DispatcherObject.)
Propriété publiqueEffectObtient ou définit l'effet bitmap à appliquer à ContainerVisual.
Propriété publiqueIsSealedRécupère une valeur qui indique si cette instance est actuellement sealed (en lecture seule). (Hérité de DependencyObject.)
Propriété publiqueOffsetObtient ou définit la valeur offset du ContainerVisual à partir de son point de référence.
Propriété publiqueOpacityObtient ou définit l'opacité du ContainerVisual, selon 0=transparent, 1=opaque.
Propriété publiqueOpacityMaskObtient ou définit un pinceau qui spécifie un masque d'opacité possible pour le ContainerVisual.
Propriété publiqueParentObtient le Visual parent pour le ContainerVisual.
Propriété publiqueTransformObtient ou définit la transformation qui est appliquée au ContainerVisual.
Propriété protégéeVisualBitmapEffect Obsolète. Obtient ou définit la valeur BitmapEffect du Visual. (Hérité de Visual.)
Propriété protégéeVisualBitmapEffectInput Obsolète. Obtient ou définit la valeur BitmapEffectInput du Visual. (Hérité de Visual.)
Propriété protégéeVisualBitmapScalingModeObtient ou définit le BitmapScalingMode de Visual. (Hérité de Visual.)
Propriété protégéeVisualCacheModeObtient ou définit une représentation mise en cache de Visual. (Hérité de Visual.)
Propriété protégéeVisualChildrenCountObtient le nombre d'enfants pour le ContainerVisual. (Substitue Visual.VisualChildrenCount.)
Propriété protégéeVisualClearTypeHintObtient ou définit le ClearTypeHint qui détermine la façon dont ClearType est rendu dans Visual. (Hérité de Visual.)
Propriété protégéeVisualClipObtient ou définit la zone de découpage du Visual en tant que valeur Geometry. (Hérité de Visual.)
Propriété protégéeVisualEdgeModeObtient ou définit le mode de bord du Visual en tant que valeur EdgeMode. (Hérité de Visual.)
Propriété protégéeVisualEffectObtient ou définit l'effet bitmap à appliquer à Visual. (Hérité de Visual.)
Propriété protégéeVisualOffsetObtient ou définit la valeur de décalage de l'objet visuel. (Hérité de Visual.)
Propriété protégéeVisualOpacityObtient ou définit l'opacité du Visual. (Hérité de Visual.)
Propriété protégéeVisualOpacityMaskObtient ou définit la valeur Brush qui représente le masque d'opacité du Visual. (Hérité de Visual.)
Propriété protégéeVisualParentObtient le parent d'arborescence d'éléments visuels de l'objet visuel. (Hérité de Visual.)
Propriété protégéeVisualScrollableAreaClipObtient ou définit une zone à défilement découpée pour Visual. (Hérité de Visual.)
Propriété protégéeVisualTextHintingModeObtient ou définit le TextHintingMode de Visual. (Hérité de Visual.)
Propriété protégéeVisualTextRenderingModeObtient ou définit le TextRenderingMode de Visual. (Hérité de Visual.)
Propriété protégéeVisualTransformObtient ou définit la valeur Transform du Visual. (Hérité de Visual.)
Propriété protégéeVisualXSnappingGuidelinesObtient ou définit la collection d'indications de la coordonnée x (vertical). (Hérité de Visual.)
Propriété protégéeVisualYSnappingGuidelinesObtient ou définit la collection d'indications de la coordonnée y (horizontal). (Hérité de Visual.)
Propriété publiqueXSnappingGuidelinesObtient ou définit l'indication X (horizontale) pour le ContainerVisual.
Propriété publiqueYSnappingGuidelinesObtient ou définit l'indication Y (verticale) pour le ContainerVisual.
Début

  NomDescription
Méthode protégéeAddVisualChildDéfinit la relation parent-enfant entre deux objets visuels. (Hérité de Visual.)
Méthode publiqueCheckAccessDétermine si le thread appelant a accès à ce DispatcherObject. (Hérité de DispatcherObject.)
Méthode publiqueClearValue(DependencyProperty)Efface la valeur de proximité d'une propriété. La propriété à effacer est spécifiée par un identificateur DependencyProperty. (Hérité de DependencyObject.)
Méthode publiqueClearValue(DependencyPropertyKey)Efface la valeur de proximité d'une propriété en lecture seule. La propriété à effacer est spécifiée par un DependencyPropertyKey. (Hérité de DependencyObject.)
Méthode publiqueCoerceValueForce la valeur de la propriété de dépendance spécifiée. Cette opération est accomplie en appelant toute fonction CoerceValueCallback spécifiée dans les métadonnées de propriété pour la propriété de dépendance comme elle existe sur le DependencyObject appelant. (Hérité de DependencyObject.)
Méthode publiqueEqualsDétermine si un DependencyObject fourni est équivalent au DependencyObject réel. (Hérité de DependencyObject.)
Méthode protégéeFinalize Autorise un objet à tenter de libérer des ressources et d'exécuter d'autres opérations de nettoyage avant qu'il ne soit récupéré par l'opération garbage collection. (Hérité de Object.)
Méthode publiqueFindCommonVisualAncestorRetourne l'ancêtre commun de deux objets visuels. (Hérité de Visual.)
Méthode publiqueGetHashCodeObtient un code de hachage pour ce DependencyObject. (Hérité de DependencyObject.)
Méthode publiqueGetLocalValueEnumeratorCré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.)
Méthode publiqueGetTypeObtient le Type de l'instance actuelle. (Hérité de Object.)
Méthode publiqueGetValueRetourne la valeur effective actuelle d'une propriété de dépendance sur cette instance d'un DependencyObject. (Hérité de DependencyObject.)
Méthode protégéeGetVisualChildRetourne un enfant Visual spécifié pour le parent ContainerVisual. (Substitue Visual.GetVisualChild(Int32).)
Méthode publiqueHitTest(Point)Retourne l'objet visuel supérieur d'un test de positionnement en spécifiant un Point.
Méthode publiqueHitTest(HitTestFilterCallback, HitTestResultCallback, HitTestParameters)Initialise un test de positionnement sur le ContainerVisual en utilisant les objets HitTestFilterCallback et HitTestResultCallback.
Méthode protégéeHitTestCore(GeometryHitTestParameters)Détermine si la valeur d'une géométrie s'inscrit dans les limites de l'objet visuel. (Hérité de Visual.)
Méthode protégéeHitTestCore(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.)
Méthode publiqueInvalidatePropertyRéévalue la valeur effective pour la propriété de dépendance spécifiée (Hérité de DependencyObject.)
Méthode publiqueIsAncestorOfDétermine si l'objet visuel est un ancêtre de l'objet visuel descendant. (Hérité de Visual.)
Méthode publiqueIsDescendantOfDétermine si l'objet visuel est un descendant de l'objet visuel ancêtre. (Hérité de Visual.)
Méthode protégéeMemberwiseCloneCrée une copie superficielle de l'objet Object actuel. (Hérité de Object.)
Méthode protégéeOnPropertyChangedAppelé à 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 été modifiée est signalée dans les données d'événement. (Hérité de DependencyObject.)
Méthode protégéeOnVisualChildrenChangedAppelé lorsque le VisualCollection de l'objet visuel est modifié. (Hérité de Visual.)
Méthode protégéeOnVisualParentChangedAppelé lorsque le parent de l'objet visuel est modifié. (Hérité de Visual.)
Méthode publiquePointFromScreenConvertit 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.)
Méthode publiquePointToScreenConvertit 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.)
Méthode publiqueReadLocalValueRetourne la valeur de proximité d'une propriété de dépendance, si elle existe. (Hérité de DependencyObject.)
Méthode protégéeRemoveVisualChildSupprime la relation parent-enfant entre deux objets visuels. (Hérité de Visual.)
Méthode publiqueSetCurrentValueDéfinit la valeur d'une propriété de dépendance sans modifier sa source de valeur. (Hérité de DependencyObject.)
Méthode publiqueSetValue(DependencyProperty, Object)Définit la valeur de proximité d'une propriété de dépendance, spécifiée par son identificateur de propriété de dépendance. (Hérité de DependencyObject.)
Méthode publiqueSetValue(DependencyPropertyKey, Object)Définit la valeur de proximité 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.)
Méthode protégéeShouldSerializePropertyRetourne une valeur qui indique si les processus de sérialisation doivent sérialiser la valeur pour la propriété de dépendance fournie. (Hérité de DependencyObject.)
Méthode publiqueToStringRetourne une chaîne qui représente l'objet actif. (Hérité de Object.)
Méthode publiqueTransformToAncestor(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.)
Méthode publiqueTransformToAncestor(Visual3D)Retourne une transformation qui peut être utilisée pour transformer les coordonnées de Visual en l'ancêtre Visual3D spécifié de l'objet visuel. (Hérité de Visual.)
Méthode publiqueTransformToDescendantRetourne 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.)
Méthode publiqueTransformToVisualRetourne une transformation qui peut être utilisée pour transformer les coordonnées du Visual dans l'objet visuel spécifié. (Hérité de Visual.)
Méthode publiqueVerifyAccessGarantit que le thread appelant a accès à DispatcherObject. (Hérité de DispatcherObject.)
Début

La classe ContainerVisual est utilisée comme un conteneur pour une collection d'objets Visual. La classe DrawingVisual dérive de la classe ContainerVisual, de telle manière que la classe DrawingVisual peut également contenir une collection d'objets visuels.

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


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


.NET Framework

Pris en charge dans : 4.5.2, 4.5.1, 4.5, 4, 3.5, 3.0

.NET Framework Client Profile

Pris en charge dans : 4, 3.5 SP1

Windows Phone 8.1, Windows Phone 8, Windows 8.1, Windows Server 2012 R2, Windows 8, Windows Server 2012, Windows 7, Windows Vista SP2, Windows Server 2008 (rôle principal du serveur non pris en charge), Windows Server 2008 R2 (rôle principal du serveur pris en charge avec SP1 ou version ultérieure ; Itanium non pris en charge)

Le .NET Framework ne prend pas en charge toutes les versions de chaque plateforme. Pour obtenir la liste des versions prises en charge, consultez Configuration requise du .NET Framework.

Tous les membres static (Shared en Visual Basic) publics de ce type sont thread-safe. Il n'est pas garanti que les membres d'instance soient thread-safe.

Ajouts de la communauté

Afficher:
© 2015 Microsoft