ModelVisual3D Klasa

Definicja

Udostępnia obiekty renderujące Model3D. Visual3DProvides a Visual3D that renders Model3D objects.

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
type ModelVisual3D = class
    inherit Visual3D
    interface IAddChild
Public Class ModelVisual3D
Inherits Visual3D
Implements IAddChild
Dziedziczenie
Atrybuty
Implementuje

Przykłady

W poniższym przykładzie pokazano wystąpienie elementu ModelVisual3D w znaczniku.The following example shows an instance of ModelVisual3D in markup. myTeapotodwołuje się MeshGeometry3D do zdefiniowanej zewnętrznie.myTeapot refers to a MeshGeometry3D defined externally. Można zastąpić dowolną geometrię własną.You can substitute any geometry of your own.

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

Uwagi

Zapewnia usługi i właściwości, które są wspólne dla wszystkich obiektów wizualizacji, w tym testowania trafień, transformacji współrzędnych i obliczeń w polu obwiedni.Provides services and properties that are common to all visual objects, including hit-testing, coordinate transformation, and bounding-box calculations.

Klasa ma właściwość, która umożliwia ModelVisual3D Tworzenie struktury drzewa obiektów. Children ModelVisual3DThe ModelVisual3D class has a Children property that enables you to build a tree structure of ModelVisual3D objects.

ModelVisual3Dobiekty są zoptymalizowane jako węzły sceny.ModelVisual3D objects are optimized as scene nodes. Na przykład buforują granice.For example, they cache bounds. Za każdym razem, gdy ModelVisual3D jest to możliwe, należy użyć obiektów dla unikatowych wystąpień obiektów w scenie.Whenever you can, use ModelVisual3D objects for unique instances of objects within your scene. To użycie różni Model3D się od obiektów, które są lekkimi obiektami, które są zoptymalizowane pod kątem współużytkowania i użycia.This usage contrasts with that of Model3D objects, which are lightweight objects that are optimized to be shared and reused. Na przykład użyj Model3D obiektu, aby skompilować model samochodu, i użyj dziesięciu ModelVisual3D obiektów, aby umieścić dziesięć samochodów w scenie.For example, use a Model3D object to build a model of a car; and use ten ModelVisual3D objects to place ten cars in your scene.

Konstruktory

ModelVisual3D()

Inicjuje nowe wystąpienie klasy ModelVisual3D klasy.Initializes a new instance of the ModelVisual3D class.

Pola

ContentProperty

Identyfikuje właściwość Content zależności.Identifies the Content dependency property.

TransformProperty

Identyfikuje właściwość Transform zależności.Identifies the Transform dependency property.

Właściwości

Children

Pobiera kolekcję obiektów podrzędnych Visual3D .Gets a collection of child Visual3D objects.

Content

Pobiera lub ustawia model, który składa się z zawartości ModelVisual3D.Gets or sets the model that comprises the content of the ModelVisual3D.

DependencyObjectType

Pobiera DependencyObjectType, które zawijają typ CLRCLR tego wystąpienia.Gets the DependencyObjectType that wraps the CLRCLR type of this instance.

(Odziedziczone po DependencyObject)
Dispatcher

Dispatcher Pobiera ten DispatcherObject program jest skojarzony z.Gets the Dispatcher this DispatcherObject is associated with.

(Odziedziczone po DispatcherObject)
HasAnimatedProperties

Pobiera wartość wskazującą, czy ma ona Visual3D wszystkie animowane właściwości.Gets a value that indicates whether this Visual3D has any animated properties.

(Odziedziczone po Visual3D)
IsSealed

Pobiera wartość wskazującą, czy to wystąpienie jest aktualnie zapieczętowane (tylko do odczytu).Gets a value that indicates whether this instance is currently sealed (read-only).

(Odziedziczone po DependencyObject)
Transform

Pobiera lub ustawia zestaw transformacji dla ModelVisual3D.Gets or sets the transform set on the ModelVisual3D.

Visual3DChildrenCount

Zwraca liczbę obiektów podrzędnych.Returns the number of child objects.

Visual3DModel

Pobiera lub ustawia Model3D obiekt do renderowania.Gets or sets the Model3D object to render.

(Odziedziczone po Visual3D)

Metody

AddVisual3DChild(Visual3D)

Definiuje relację nadrzędny-podrzędny między dwiema wizualizacjami 3-D.Defines the parent-child relationship between two 3-D visuals.

(Odziedziczone po Visual3D)
ApplyAnimationClock(DependencyProperty, AnimationClock)

Stosuje efekt danej AnimationClock właściwości zależności.Applies the effect of a given AnimationClock to a given dependency property.

(Odziedziczone po Visual3D)
ApplyAnimationClock(DependencyProperty, AnimationClock, HandoffBehavior)

Stosuje efekt danej AnimationClock właściwości zależności.Applies the effect of a given AnimationClock to a given dependency property. Wpływ nowego AnimationClock na wszystkie bieżące animacje jest określany przez wartość handoffBehavior parametru.The effect of the new AnimationClock on any current animations is determined by the value of the handoffBehavior parameter.

(Odziedziczone po Visual3D)
BeginAnimation(DependencyProperty, AnimationTimeline)

Inicjuje sekwencję animacji dla DependencyProperty obiektu, na podstawie określonego. AnimationTimelineInitiates an animation sequence for the DependencyProperty object, based on the specified AnimationTimeline.

(Odziedziczone po Visual3D)
BeginAnimation(DependencyProperty, AnimationTimeline, HandoffBehavior)

Inicjuje sekwencję animacji dla DependencyProperty obiektu, na podstawie zarówno określonego AnimationTimeline , jak i HandoffBehavior.Initiates an animation sequence for the DependencyProperty object, based on both the specified AnimationTimeline and HandoffBehavior.

(Odziedziczone po Visual3D)
CheckAccess()

Określa, czy wątek wywołujący ma dostęp do DispatcherObjecttego.Determines whether the calling thread has access to this DispatcherObject.

(Odziedziczone po DispatcherObject)
ClearValue(DependencyProperty)

Czyści wartość lokalną właściwości.Clears the local value of a property. Właściwość, która ma zostać wyczyszczona, jest określana przez identyfikator DependencyProperty.The property to be cleared is specified by a DependencyProperty identifier.

(Odziedziczone po DependencyObject)
ClearValue(DependencyPropertyKey)

Czyści wartość lokalną właściwości tylko do odczytu.Clears the local value of a read-only property. Właściwość, która ma zostać wyczyszczona, jest określana przez DependencyPropertyKey.The property to be cleared is specified by a DependencyPropertyKey.

(Odziedziczone po DependencyObject)
CoerceValue(DependencyProperty)

Przekształca wartość określonej właściwości zależności.Coerces the value of the specified dependency property. W tym celu należy wywołać dowolną funkcję CoerceValueCallback określoną w metadanych właściwości dla właściwości zależności, która istnieje w DependencyObjectwywoływania.This is accomplished by invoking any CoerceValueCallback function specified in property metadata for the dependency property as it exists on the calling DependencyObject.

(Odziedziczone po DependencyObject)
Equals(Object)

Określa, czy podana DependencyObject jest równoważna z bieżącym DependencyObject.Determines whether a provided DependencyObject is equivalent to the current DependencyObject.

(Odziedziczone po DependencyObject)
FindCommonVisualAncestor(DependencyObject)

Zwraca wspólny element nadrzędny obiektu wizualizacji i inny określony obiekt wizualny.Returns the common ancestor of the visual object and another specified visual object.

(Odziedziczone po Visual3D)
GetAnimationBaseValue(DependencyProperty)

Pobiera wartość bazową określonego DependencyProperty obiektu.Retrieves the base value of the specified DependencyProperty object.

(Odziedziczone po Visual3D)
GetHashCode()

Pobiera kod skrótu dla tego DependencyObject.Gets a hash code for this DependencyObject.

(Odziedziczone po DependencyObject)
GetLocalValueEnumerator()

Tworzy wyspecjalizowany moduł wyliczający służący do określania, które właściwości zależności mają lokalnie ustawione wartości na tej DependencyObject.Creates a specialized enumerator for determining which dependency properties have locally set values on this DependencyObject.

(Odziedziczone po DependencyObject)
GetType()

Pobiera Type bieżącego wystąpienia.Gets the Type of the current instance.

(Odziedziczone po Object)
GetValue(DependencyProperty)

Zwraca bieżącą obowiązującą wartość właściwości zależności w tym wystąpieniu DependencyObject.Returns the current effective value of a dependency property on this instance of a DependencyObject.

(Odziedziczone po DependencyObject)
GetVisual3DChild(Int32)

Zwraca określony Visual3D element w kolekcji nadrzędnej.Returns the specified Visual3D in the parent collection.

InvalidateProperty(DependencyProperty)

Ponowna ocenuje wartość efektywną dla określonej właściwości zależności.Re-evaluates the effective value for the specified dependency property.

(Odziedziczone po DependencyObject)
IsAncestorOf(DependencyObject)

Określa, czy obiekt wizualny jest elementem nadrzędnym obiektu wizualizacji podrzędnej.Determines whether the visual object is an ancestor of the descendant visual object.

(Odziedziczone po Visual3D)
IsDescendantOf(DependencyObject)

Określa, czy obiekt wizualny jest elementem potomnym obiektu wizualizacji nadrzędnej.Determines whether the visual object is a descendant of the ancestor visual object.

(Odziedziczone po Visual3D)
MemberwiseClone()

Tworzy skróconą kopię bieżącego Object.Creates a shallow copy of the current Object.

(Odziedziczone po Object)
OnPropertyChanged(DependencyPropertyChangedEventArgs)

Wywoływana za każdym razem, gdy wartość skuteczna każdej właściwości zależności w tym DependencyObject została zaktualizowana.Invoked whenever the effective value of any dependency property on this DependencyObject has been updated. Określona właściwość zależności, która została zmieniona, jest raportowana w danych zdarzenia.The specific dependency property that changed is reported in the event data.

(Odziedziczone po DependencyObject)
OnVisualChildrenChanged(DependencyObject, DependencyObject)

Wywołuje się, Visual3DCollection gdy obiekt wizualny jest modyfikowany.Called when the Visual3DCollection of the visual object is modified.

(Odziedziczone po Visual3D)
OnVisualParentChanged(DependencyObject)

Wywołuje się, gdy obiekt nadrzędny obiektu wizualnego 3-D zostanie zmieniony.Called when the parent of the 3-D visual object is changed.

(Odziedziczone po Visual3D)
ReadLocalValue(DependencyProperty)

Zwraca wartość lokalną właściwości zależności, jeśli istnieje.Returns the local value of a dependency property, if it exists.

(Odziedziczone po DependencyObject)
RemoveVisual3DChild(Visual3D)

Usuwa relację nadrzędny-podrzędny między dwiema wizualizacjami 3-D.Removes the parent-child relationship between two 3-D visuals.

(Odziedziczone po Visual3D)
SetCurrentValue(DependencyProperty, Object)

Ustawia wartość właściwości zależności bez zmiany jego źródła wartości.Sets the value of a dependency property without changing its value source.

(Odziedziczone po DependencyObject)
SetValue(DependencyProperty, Object)

Ustawia wartość lokalną właściwości zależności, określoną za pomocą identyfikatora właściwości zależności.Sets the local value of a dependency property, specified by its dependency property identifier.

(Odziedziczone po DependencyObject)
SetValue(DependencyPropertyKey, Object)

Ustawia wartość lokalną właściwości zależności tylko do odczytu, określoną przez DependencyPropertyKey identyfikator właściwości zależności.Sets the local value of a read-only dependency property, specified by the DependencyPropertyKey identifier of the dependency property.

(Odziedziczone po DependencyObject)
ShouldSerializeProperty(DependencyProperty)

Zwraca wartość wskazującą, czy procesy serializacji powinny serializować wartość dla podanej właściwości zależności.Returns a value that indicates whether serialization processes should serialize the value for the provided dependency property.

(Odziedziczone po DependencyObject)
ToString()

Zwraca ciąg, który reprezentuje bieżący obiekt.Returns a string that represents the current object.

(Odziedziczone po Object)
TransformToAncestor(Visual)

Zwraca transformację, która może być użyta do przekształcenia współrzędnych z Visual3D tego Visual obiektu do określonego elementu nadrzędnego obiektu.Returns a transform that can be used to transform coordinates from this Visual3D object to the specified Visual ancestor of the object.

(Odziedziczone po Visual3D)
TransformToAncestor(Visual3D)

Zwraca transformację, która może być użyta do przekształcenia współrzędnych z Visual3D tego Visual3D obiektu do określonego elementu nadrzędnego obiektu.Returns a transform that can be used to transform coordinates from this Visual3D object to the specified Visual3D ancestor of the object.

(Odziedziczone po Visual3D)
TransformToDescendant(Visual3D)

Zwraca transformację, która może być użyta do przekształcenia współrzędnych z Visual3D tego Visual3D obiektu do określonego obiektu.Returns a transform that can be used to transform coordinates from this Visual3D object to the specified Visual3D descent object.

(Odziedziczone po Visual3D)
VerifyAccess()

Wymusza, że wątek wywołujący ma dostęp do tego DispatcherObject.Enforces that the calling thread has access to this DispatcherObject.

(Odziedziczone po DispatcherObject)

Jawne implementacje interfejsu

IAddChild.AddChild(Object)

Dodaje obiekt podrzędny.Adds a child object.

IAddChild.AddText(String)

Dodaje zawartość tekstową węzła do obiektu.Adds the text content of a node to the object.

Dotyczy