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

Rendert die untergeordneten 2D-Elemente innerhalb der angegebenen 3D-Viewportgrenzen.

public ref class Viewport2DVisual3D sealed : System::Windows::Media::Media3D::Visual3D

[System.Windows.Markup.ContentProperty("Visual")]
public sealed class Viewport2DVisual3D : System.Windows.Media.Media3D.Visual3D

[<System.Windows.Markup.ContentProperty("Visual")>]
type Viewport2DVisual3D = class
    inherit Visual3D

Public NotInheritable Class Viewport2DVisual3D
Inherits Visual3D

Vererbung: Object

DispatcherObject

DependencyObject

Visual3D
Viewport2DVisual3D

Attribute: ContentPropertyAttribute

Beispiele

Das folgende Beispiel zeigt, wie Sie eine Schaltfläche, ein 2D-Objekt, auf einem 3D-Objekt platzieren. Beachten Sie, dass Sie die IsVisualHostMaterial angefügte Eigenschaft für das Material festlegen müssen, auf dem Sie die 2D-Visualisierung platzieren möchten.

<Viewport3D>
    <Viewport3D.Camera>
        <PerspectiveCamera Position="0, 0, 4"/>
    </Viewport3D.Camera>
    
    <!-- Button on 3D -->
    <Viewport2DVisual3D>
        <!-- Give the plane a slight rotation -->
        <Viewport2DVisual3D.Transform>
            <RotateTransform3D>
                <RotateTransform3D.Rotation>
                    <AxisAngleRotation3D Angle="40" Axis="0, 1, 0" />
                </RotateTransform3D.Rotation>
            </RotateTransform3D>
        </Viewport2DVisual3D.Transform>
        
        <!-- The Geometry, Material, and Visual for the Viewport2DVisual3D -->
        <Viewport2DVisual3D.Geometry>
            <MeshGeometry3D Positions="-1,1,0 -1,-1,0 1,-1,0 1,1,0"
                            TextureCoordinates="0,0 0,1 1,1 1,0" TriangleIndices="0 1 2 0 2 3"/>
        </Viewport2DVisual3D.Geometry>

        <Viewport2DVisual3D.Material>
            <DiffuseMaterial Viewport2DVisual3D.IsVisualHostMaterial="True" Brush="White"/>
        </Viewport2DVisual3D.Material>                               
        
        <Button>Hello, 3D</Button>
    </Viewport2DVisual3D>
    
    <!-- Lights -->
    <ModelVisual3D>
        <ModelVisual3D.Content>
            <DirectionalLight Color="#FFFFFFFF" Direction="0,0,-1"/>
        </ModelVisual3D.Content>
    </ModelVisual3D>
</Viewport3D>

Hinweise

Viewport2DVisual3D ermöglicht es Ihnen, interaktive 2D-Inhalte auf einem 3D-Objekt zu platzieren. Sein Gegenstück ist die Viewport3DVisual Klasse, die ein 2D-Visuelles mit 3D-Kindern ist.

Viewport2DVisual3Dwird in der .NET Framework Version 3.5 eingeführt.

Konstruktoren

Viewport2DVisual3D()

Initialisiert eine neue Instanz der Viewport2DVisual3D-Klasse.

Felder

CacheModeProperty	Bezeichnet die CacheMode-Abhängigkeitseigenschaft.
GeometryProperty	Bezeichnet die Geometry-Abhängigkeitseigenschaft.
IsVisualHostMaterialProperty	Bezeichnet die angefügte IsVisualHostMaterial-Eigenschaft.
MaterialProperty	Bezeichnet die Material-Abhängigkeitseigenschaft.
VisualProperty	Bezeichnet die Visual-Abhängigkeitseigenschaft.

Eigenschaften

CacheMode	Ruft eine zwischengespeicherte Darstellung des Viewport2DVisual3D ab oder legt diese fest.
DependencyObjectType	Ruft den DependencyObjectType CLR-Typ dieser Instanz ab. (Geerbt von DependencyObject)
Dispatcher	Ruft den Dispatcher ab, der diesem DispatcherObject zugeordnet ist. (Geerbt von DispatcherObject)
Geometry	Ruft die 3D-Geometrie für dieses Viewport2DVisual3D ab oder legt diese fest.
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)
Material	Ruft das Material ab, das die Darstellung des 3D-Objekts beschreibt, oder legt dieses Material fest.
Transform	Ruft die auf das 3D-Objekt angewendete Transformation ab oder legt diese fest. (Geerbt von Visual3D)
Visual	Ruft das visuelle 2D-Objekt ab, das auf dem 3D-Objekt platziert werden soll, oder legt dieses fest.
Visual3DChildrenCount	Ruft die Anzahl untergeordneter Elemente für das Visual3D-Objekt ab. (Geerbt von Visual3D)
Visual3DModel	Ruft das zu rendernde Model3D-Objekt ab oder legt dieses fest. (Geerbt von Visual3D)

Angefügte Eigenschaften

IsVisualHostMaterial

Ruft einen Wert ab, der angibt, ob ein Material interaktiv sein soll, oder legt diesen Wert fest.

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)
GetIsVisualHostMaterial(Material)	Ruft den Wert der angefügten IsVisualHostMaterial-Eigenschaft für ein angegebenes UIElement ab.
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 Visual3DCollection zurück. (Geerbt von Visual3D)
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)
SetIsVisualHostMaterial(Material, Boolean)	Legt den Wert der angefügten IsVisualHostMaterial-Eigenschaft auf ein angegebenes Element fest.
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)

Gilt für