ModelVisual3D Classe

Référence

Définition

Espace de noms:: System.Windows.Media.Media3D

Assembly:: PresentationCore.dll

Important

Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.

Fournit un Visual3D qui restitue les objets Model3D.

public ref class ModelVisual3D : System::Windows::Media::Media3D::Visual3D, System::Windows::Markup::IAddChild

[System.Windows.Markup.ContentProperty("Children")]
public class ModelVisual3D : System.Windows.Media.Media3D.Visual3D, System.Windows.Markup.IAddChild

[<System.Windows.Markup.ContentProperty("Children")>]
type ModelVisual3D = class
    inherit Visual3D
    interface IAddChild

Public Class ModelVisual3D
Inherits Visual3D
Implements IAddChild

Héritage: Object

DispatcherObject

DependencyObject

Visual3D
ModelVisual3D

Attributs: ContentPropertyAttribute

Implémente: IAddChild

Exemples

L’exemple suivant montre une instance de ModelVisual3D dans le balisage. myTeapot fait référence à un MeshGeometry3D défini en externe. Vous pouvez remplacer n’importe quelle géométrie de votre propre.

<DockPanel>
  <Viewport3D Name="myViewport">

    <Viewport3D.Camera>
      <PerspectiveCamera FarPlaneDistance="20" LookDirection="5,-2,-3" UpDirection="0,1,0" NearPlaneDistance="0" Position="-5,2,3" FieldOfView="45" />
    </Viewport3D.Camera>

    <ModelVisual3D x:Name="topModelVisual3D">
      <ModelVisual3D.Children>
        <ModelVisual3D>
          <ModelVisual3D.Content>
            <DirectionalLight Color="#FFFFFFFF" Direction="-3,-4,-5" />
          </ModelVisual3D.Content>
        </ModelVisual3D>

        <ModelVisual3D>
          <ModelVisual3D.Content>
            <GeometryModel3D Geometry="{StaticResource myTeapot}">
              <GeometryModel3D.Material>
                <DiffuseMaterial>
                  <DiffuseMaterial.Brush>
                    <SolidColorBrush Color="Blue" Opacity="1.0" />
                  </DiffuseMaterial.Brush>
                </DiffuseMaterial>
              </GeometryModel3D.Material>
              <GeometryModel3D.Transform>
                <RotateTransform3D>
                  <RotateTransform3D.Rotation>
                    <AxisAngleRotation3D x:Name="myAngleRotation" Axis="0,3,0" Angle="1" />
                  </RotateTransform3D.Rotation>
                </RotateTransform3D>
              </GeometryModel3D.Transform>
            </GeometryModel3D>
          </ModelVisual3D.Content>
        </ModelVisual3D>


      </ModelVisual3D.Children>
    </ModelVisual3D>


    <Viewport3D.Triggers>

      <EventTrigger RoutedEvent="Viewport3D.Loaded">
        <BeginStoryboard>
          <Storyboard>
            <DoubleAnimation 
              Storyboard.TargetName="myAngleRotation"
              Storyboard.TargetProperty="Angle"
              From="0" To="360" Duration="0:0:10"
              RepeatBehavior="Forever" />
          </Storyboard>
        </BeginStoryboard>
      </EventTrigger>
    </Viewport3D.Triggers>


  </Viewport3D>
</DockPanel>

Remarques

Fournit des services et des propriétés communs à tous les objets visuels, y compris les tests d’accès, la transformation de coordonnées et les calculs de zone englobante.

La ModelVisual3D classe a une Children propriété qui vous permet de créer une arborescence d’objets ModelVisual3D .

ModelVisual3D les objets sont optimisés en tant que nœuds de scène. Par exemple, ils mettent en cache des limites. Chaque fois que vous le pouvez, utilisez des ModelVisual3D objets pour des instances uniques d’objets au sein de votre scène. Cette utilisation contraste avec celle des objets, qui sont des Model3D objets légers qui sont optimisés pour être partagés et réutilisés. Par exemple, utilisez un Model3D objet pour créer un modèle d’une voiture et utilisez dix ModelVisual3D objets pour placer dix voitures dans votre scène.

Constructeurs

ModelVisual3D()

Initialise une nouvelle instance de la classe ModelVisual3D.

Champs

ContentProperty	Identifie la propriété de dépendance Content.
TransformProperty	Identifie la propriété de dépendance Transform.

Propriétés

Children	Obtient une collection d'objets Visual3D enfants.
Content	Obtient ou définit le modèle qui décrit le contenu de ModelVisual3D.
DependencyObjectType	Obtient le DependencyObjectType qui encapsule le type CLR de cette instance. (Hérité de DependencyObject)
Dispatcher	Obtient le Dispatcher associé à DispatcherObject. (Hérité de DispatcherObject)
HasAnimatedProperties	Obtient une valeur qui indique si ce Visual3D comporte des propriétés animées. (Hérité de Visual3D)
IsSealed	Récupère une valeur qui indique si cette instance est actuellement sealed (en lecture seule). (Hérité de DependencyObject)
Transform	Obtient ou définit les éléments de transformation appliqués à ModelVisual3D.
Visual3DChildrenCount	Retourne le nombre d'objets enfants.
Visual3DModel	Obtient ou définit l'objet Model3D à restituer. (Hérité de Visual3D)

Méthodes

AddVisual3DChild(Visual3D)	Définit la relation parent-enfant entre deux objets visuels 3D. (Hérité de Visual3D)
ApplyAnimationClock(DependencyProperty, AnimationClock)	Applique l’effet d’un AnimationClock donné à une propriété de dépendance donnée. (Hérité de Visual3D)
ApplyAnimationClock(DependencyProperty, AnimationClock, HandoffBehavior)	Applique l’effet d’un AnimationClock donné à une propriété de dépendance donnée. L'impact d'une nouvelle horloge AnimationClock sur les animations en cours est déterminé par la valeur du paramètre `handoffBehavior` (Hérité de Visual3D)
BeginAnimation(DependencyProperty, AnimationTimeline)	Initialise une séquence d’animation pour l’objet DependencyProperty, en fonction du AnimationTimeline spécifié. (Hérité de Visual3D)
BeginAnimation(DependencyProperty, AnimationTimeline, HandoffBehavior)	Démarre une séquence d'animation pour l'objet DependencyProperty, en fonction à la fois de la chronologie AnimationTimeline et du comportement HandoffBehavior spécifiés. (Hérité de Visual3D)
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 l'objet visuel et d'un autre objet visuel spécifié. (Hérité de Visual3D)
GetAnimationBaseValue(DependencyProperty)	Récupère la valeur de base de l'objet DependencyProperty spécifié. (Hérité de Visual3D)
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)
GetVisual3DChild(Int32)	Retourne le Visual3D spécifié dans la collection parent.
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 Visual3D)
IsDescendantOf(DependencyObject)	Détermine si l'objet visuel est un descendant de l'objet visuel ancêtre. (Hérité de Visual3D)
MemberwiseClone()	Crée une copie superficielle du Object actuel. (Hérité de Object)
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 Visual3DCollection de l'objet visuel est modifié. (Hérité de Visual3D)
OnVisualParentChanged(DependencyObject)	Appelé lorsque le parent de l'objet visuel 3D est modifié. (Hérité de Visual3D)
ReadLocalValue(DependencyProperty)	Retourne la valeur locale d’une propriété de dépendance, si elle existe. (Hérité de DependencyObject)
RemoveVisual3DChild(Visual3D)	Supprime la relation parent-enfant entre deux objets visuels 3D. (Hérité de Visual3D)
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 de cet objet Visual3D dans l'ancêtre Visual spécifié de l'objet. (Hérité de Visual3D)
TransformToAncestor(Visual3D)	Retourne une transformation qui peut être utilisée pour transformer les coordonnées de cet objet Visual3D dans l'ancêtre Visual3D spécifié de l'objet. (Hérité de Visual3D)
TransformToDescendant(Visual3D)	Retourne une transformation qui peut être utilisée pour transformer les coordonnées de cet objet Visual3D à l’objet descendant Visual3D spécifié. (Hérité de Visual3D)
VerifyAccess()	Garantit que le thread appelant a accès à DispatcherObject. (Hérité de DispatcherObject)

Implémentations d’interfaces explicites

IAddChild.AddChild(Object)	Ajoute un objet enfant.
IAddChild.AddText(String)	Ajoute le contenu textuel d’un nœud à l’objet.

S’applique à