ModelVisual3D Klasse

Referenz

Definition

Namespace:: System.Windows.Media.Media3D

Assembly:: PresentationCore.dll

Wichtig

Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.

Stellt ein Visual3D bereit, das Model3D-Objekte rendert.

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

Vererbung: Object

DispatcherObject

DependencyObject

Visual3D
ModelVisual3D

Attribute: ContentPropertyAttribute

Implementiert: IAddChild

Beispiele

Das folgende Beispiel zeigt eine Instanz von ModelVisual3D im Markup. myTeapot verweist auf ein definiertes externes MeshGeometry3D Element. Sie können jede eigene Geometrie ersetzen.

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

Hinweise

Stellt Dienste und Eigenschaften bereit, die allen visuellen Objekten gemeinsam sind, einschließlich Treffertests, Koordinatentransformationen und Begrenzungsrahmenberechnungen.

Die ModelVisual3D -Klasse verfügt über eine Children -Eigenschaft, mit der Sie eine Struktur von ModelVisual3D Objekten erstellen können.

ModelVisual3D -Objekte werden als Szenenknoten optimiert. Sie speichern z. B. Grenzen zwischen. Verwenden ModelVisual3D Sie nach Möglichkeit Objekte für eindeutige Instanzen von Objekten in Ihrer Szene. Diese Verwendung steht im Gegensatz zu der von Model3D Objekten, bei denen es sich um einfache Objekte handelt, die für die Freigabe und Wiederverwendung optimiert sind. Verwenden Sie beispielsweise ein Model3D -Objekt, um ein Modell eines Autos zu erstellen, und verwenden Sie zehn ModelVisual3D Objekte, um zehn Autos in Ihrer Szene zu platzieren.

Konstruktoren

ModelVisual3D()

Initialisiert eine neue Instanz der ModelVisual3D-Klasse.

Felder

ContentProperty	Bezeichnet die Content-Abhängigkeitseigenschaft.
TransformProperty	Bezeichnet die Transform-Abhängigkeitseigenschaft.

Eigenschaften

Children	Ruft eine Auflistung von untergeordneten Visual3D-Objekten ab.
Content	Ruft das Modell ab, das den Inhalt des ModelVisual3D umfasst, oder legt dieses fest.
DependencyObjectType	Ruft den DependencyObjectType ab, der den CLR-Typ dieser Instanz umschließt. (Geerbt von DependencyObject)
Dispatcher	Ruft den Dispatcher ab, der diesem DispatcherObject zugeordnet ist. (Geerbt von DispatcherObject)
HasAnimatedProperties	Ruft einen Wert ab, der angibt, ob dieses Visual3D über animierte Eigenschaften verfügt. (Geerbt von Visual3D)
IsSealed	Ruft einen Wert ab, der angibt, ob diese Instanz derzeit versiegelt (schreibgeschützt) ist. (Geerbt von DependencyObject)
Transform	Ruft die für das ModelVisual3D festgelegte Transformation ab oder legt diese fest.
Visual3DChildrenCount	Gibt die Anzahl untergeordneter Objekte zurück.
Visual3DModel	Ruft das zu rendernde Model3D-Objekt ab oder legt dieses fest. (Geerbt von Visual3D)

Methoden

AddVisual3DChild(Visual3D)	Definiert die hierarchische Beziehung zwischen zwei visuellen 3D-Elementen. (Geerbt von Visual3D)
ApplyAnimationClock(DependencyProperty, AnimationClock)	Wendet den Effekt einer angegebenen AnimationClock auf eine angegebene Abhängigkeitseigenschaft an. (Geerbt von Visual3D)
ApplyAnimationClock(DependencyProperty, AnimationClock, HandoffBehavior)	Wendet den Effekt einer angegebenen AnimationClock auf eine angegebene Abhängigkeitseigenschaft an. Die Auswirkung der neuen AnimationClock auf aktuelle Animationen wird durch den Wert des `handoffBehavior`-Parameters bestimmt. (Geerbt von Visual3D)
BeginAnimation(DependencyProperty, AnimationTimeline)	Löst eine Animationssequenz für das DependencyProperty-Objekt auf Grundlage der angegebenen AnimationTimeline aus. (Geerbt von Visual3D)
BeginAnimation(DependencyProperty, AnimationTimeline, HandoffBehavior)	Initiiert eine Animationssequenz für das DependencyProperty-Objekt auf der Grundlage der angegebenen AnimationTimeline und des angegebenen HandoffBehavior. (Geerbt von Visual3D)
CheckAccess()	Bestimmt, ob der aufrufende Thread auf dieses DispatcherObject zugreifen kann. (Geerbt von DispatcherObject)
ClearValue(DependencyProperty)	Löscht den lokalen Wert einer Eigenschaft. Die Eigenschaft, deren Wert gelöscht werden soll, wird durch einen DependencyProperty-Bezeichner angegeben. (Geerbt von DependencyObject)
ClearValue(DependencyPropertyKey)	Löscht den lokalen Wert einer schreibgeschützten Eigenschaft. Die Eigenschaft, deren Wert gelöscht werden soll, wird durch einen DependencyPropertyKey angegeben. (Geerbt von DependencyObject)
CoerceValue(DependencyProperty)	Erzwingt den Wert der angegebenen Abhängigkeitseigenschaft. Dies erfolgt durch den Aufruf einer beliebigen CoerceValueCallback-Funktion, die in den Metadaten für die Abhängigkeitseigenschaft angegeben ist, während sie beim aufrufenden DependencyObject beendet wird. (Geerbt von DependencyObject)
Equals(Object)	Bestimmt, ob ein angegebenes DependencyObject dem aktuellen DependencyObject entspricht. (Geerbt von DependencyObject)
FindCommonVisualAncestor(DependencyObject)	Gibt das gemeinsame Vorgängerobjekt des visuellen Objekts und eines weiteren angegebenen visuellen Objekts zurück. (Geerbt von Visual3D)
GetAnimationBaseValue(DependencyProperty)	Ruft den Basiswert des angegebenen DependencyProperty-Objekts ab. (Geerbt von Visual3D)
GetHashCode()	Ruft einen Hashcode für diese DependencyObject ab. (Geerbt von DependencyObject)
GetLocalValueEnumerator()	Erstellt einen spezialisierten Enumerator, mit dem bestimmt wird, welche Abhängigkeitseigenschaften dieses DependencyObject über lokal festgelegte Werte verfügen. (Geerbt von DependencyObject)
GetType()	Ruft den Type der aktuellen Instanz ab. (Geerbt von Object)
GetValue(DependencyProperty)	Gibt den aktuellen effektiven Wert einer Abhängigkeitseigenschaft für diese Instanz eines DependencyObject zurück. (Geerbt von DependencyObject)
GetVisual3DChild(Int32)	Gibt das angegebene Visual3D in der übergeordneten Auflistung zurück.
InvalidateProperty(DependencyProperty)	Wertet den effektiven Wert für die angegebene Abhängigkeitseigenschaft erneut aus. (Geerbt von DependencyObject)
IsAncestorOf(DependencyObject)	Bestimmt, ob das visuelle Objekt ein Vorgänger des visuellen Nachfolgerobjekts ist. (Geerbt von Visual3D)
IsDescendantOf(DependencyObject)	Bestimmt, ob das visuelle Objekt ein Nachfolger des visuellen Vorgängerobjekts ist. (Geerbt von Visual3D)
MemberwiseClone()	Erstellt eine flache Kopie des aktuellen Object. (Geerbt von Object)
OnPropertyChanged(DependencyPropertyChangedEventArgs)	Wird immer dann aufgerufen, wenn der effektive Wert einer Abhängigkeitseigenschaft für dieses DependencyObject aktualisiert wurde. Welche spezifische Abhängigkeitseigenschaft geändert wird, wird in den Ereignisdaten gemeldet. (Geerbt von DependencyObject)
OnVisualChildrenChanged(DependencyObject, DependencyObject)	Wird aufgerufen, wenn die Visual3DCollection des visuellen Objekts geändert wurde. (Geerbt von Visual3D)
OnVisualParentChanged(DependencyObject)	Wird aufgerufen, wenn das übergeordnete Element des visuellen 3D-Objekts geändert wird. (Geerbt von Visual3D)
ReadLocalValue(DependencyProperty)	Gibt den lokalen Wert einer Abhängigkeitseigenschaft zurück, wenn dieser vorhanden ist. (Geerbt von DependencyObject)
RemoveVisual3DChild(Visual3D)	Entfernt die hierarchische Beziehung zwischen zwei visuellen 3D-Elementen. (Geerbt von Visual3D)
SetCurrentValue(DependencyProperty, Object)	Legt den Wert einer Abhängigkeitseigenschaft fest, ohne deren Wertquelle zu ändern. (Geerbt von DependencyObject)
SetValue(DependencyProperty, Object)	Legt den lokalen Wert einer Abhängigkeitseigenschaft fest, die durch ihren Bezeichner angegeben ist. (Geerbt von DependencyObject)
SetValue(DependencyPropertyKey, Object)	Legt den lokalen Wert einer schreibgeschützten Abhängigkeitseigenschaft fest, die durch den DependencyPropertyKey-Bezeichner der Abhängigkeitseigenschaft angegeben ist. (Geerbt von DependencyObject)
ShouldSerializeProperty(DependencyProperty)	Gibt einen Wert zurück, der angibt, ob Serialisierungsprozesse den Wert der bereitgestellten Abhängigkeitseigenschaft serialisieren sollen. (Geerbt von DependencyObject)
ToString()	Gibt eine Zeichenfolge zurück, die das aktuelle Objekt darstellt. (Geerbt von Object)
TransformToAncestor(Visual)	Gibt eine Transformation zurück, mit der Koordinaten dieses Visual3D-Objekts in den Visual-Vorgänger des Objekts transformiert werden können. (Geerbt von Visual3D)
TransformToAncestor(Visual3D)	Gibt eine Transformation zurück, mit der Koordinaten dieses Visual3D-Objekts in den Visual3D-Vorgänger des Objekts transformiert werden können. (Geerbt von Visual3D)
TransformToDescendant(Visual3D)	Gibt eine Transformation zurück, die verwendet werden kann, um Koordinaten dieses Visual3D-Objekts in das angegebene Visual3D-Unterlängenobjekt zu transformieren. (Geerbt von Visual3D)
VerifyAccess()	Erzwingt, dass der aufrufende Thread auf dieses DispatcherObject zugreifen kann. (Geerbt von DispatcherObject)

Explizite Schnittstellenimplementierungen

IAddChild.AddChild(Object)	Fügt ein untergeordnetes Objekt hinzu.
IAddChild.AddText(String)	Fügt dem Objekt den Textinhalt eines Knotens hinzu.

Gilt für: