Viewport2DVisual3D Viewport2DVisual3D Viewport2DVisual3D Viewport2DVisual3D Class

Определение

Прорисовывает дочерний объект 2-D в указанных границах просмотра объекта 3-D.Renders the 2-D children within the specified 3-D viewport bounds.

public ref class Viewport2DVisual3D sealed : System::Windows::Media::Media3D::Visual3D
[System.Windows.Markup.ContentProperty("Visual")]
public sealed class Viewport2DVisual3D : System.Windows.Media.Media3D.Visual3D
type Viewport2DVisual3D = class
    inherit Visual3D
Public NotInheritable Class Viewport2DVisual3D
Inherits Visual3D
Наследование
Атрибуты

Примеры

В следующем примере показано, как поместить кнопку, 2-D объект, в трехмерный объект.The following example shows how to place a button, a 2-D object, on a 3-D object. Обратите внимание, что необходимо IsVisualHostMaterial задать присоединенное свойство для материала, на котором будет размещаться Трехмерный визуальный элемент.Note that you must set the IsVisualHostMaterial attached property on the material on which you wish to have the 2-D visual placed.

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

Комментарии

Viewport2DVisual3Dпозволяет размещать интерактивное трехмерное содержимое в 3-D объекте.Viewport2DVisual3D enables you to place interactive 2-D content on a 3-D object. Его аналогом является Viewport3DVisual класс, который представляет собой двумерные визуальные элементы с трехмерными дочерними элементами.Its counterpart is the Viewport3DVisual class, which is a 2-D visual with 3-D children.

Viewport2DVisual3Dвводится в .NET Framework версии 3,5.Viewport2DVisual3D is introduced in the .NET Framework version 3.5.

Конструкторы

Viewport2DVisual3D() Viewport2DVisual3D() Viewport2DVisual3D() Viewport2DVisual3D()

Инициализирует новый экземпляр класса Viewport2DVisual3D.Initializes a new instance of the Viewport2DVisual3D class.

Поля

CacheModeProperty CacheModeProperty CacheModeProperty CacheModeProperty

Идентифицирует свойство зависимостей CacheMode.Identifies the CacheMode dependency property.

GeometryProperty GeometryProperty GeometryProperty GeometryProperty

Идентифицирует свойство зависимостей Geometry.Identifies the Geometry dependency property.

IsVisualHostMaterialProperty IsVisualHostMaterialProperty IsVisualHostMaterialProperty IsVisualHostMaterialProperty

Идентифицирует присоединенное свойство IsVisualHostMaterial.Identifies the IsVisualHostMaterial attached property.

MaterialProperty MaterialProperty MaterialProperty MaterialProperty

Идентифицирует свойство зависимостей Material.Identifies the Material dependency property.

VisualProperty VisualProperty VisualProperty VisualProperty

Идентифицирует свойство зависимостей Visual.Identifies the Visual dependency property.

Свойства

CacheMode CacheMode CacheMode CacheMode

Получает или задает кэшированное представление объекта Viewport2DVisual3D.Gets or sets a cached representation of the Viewport2DVisual3D.

DependencyObjectType DependencyObjectType DependencyObjectType DependencyObjectType

Возвращает DependencyObjectType, который создает обертку для типа CLRCLR данного экземпляра.Gets the DependencyObjectType that wraps the CLRCLR type of this instance.

(Inherited from DependencyObject)
Dispatcher Dispatcher Dispatcher Dispatcher

Возвращает объект Dispatcher, с которым связан этот объект DispatcherObject.Gets the Dispatcher this DispatcherObject is associated with.

(Inherited from DispatcherObject)
Geometry Geometry Geometry Geometry

Получает или задает 3-D-геометрию для данного объекта Viewport2DVisual3D.Gets or sets the 3-D geometry for this Viewport2DVisual3D.

HasAnimatedProperties HasAnimatedProperties HasAnimatedProperties HasAnimatedProperties

Возвращает значение, указывающее, имеет ли объект Visual3D анимированные свойства.Gets a value that indicates whether this Visual3D has any animated properties.

(Inherited from Visual3D)
IsSealed IsSealed IsSealed IsSealed

Получает значение, указывающее, является ли этот экземпляр в данный момент запечатанным (доступным только для чтения).Gets a value that indicates whether this instance is currently sealed (read-only).

(Inherited from DependencyObject)
Material Material Material Material

Получает или задает материал, который описывает внешний вид объекта 3-D.Gets or sets the material that describes the appearance of the 3-D object.

Transform Transform Transform Transform

Получает или задает преобразование, применяемое к объекту 3-D.Gets or sets the transformation that is applied to the 3-D object.

(Inherited from Visual3D)
Visual Visual Visual Visual

Получает или задает визуальный объект 2-D, который требуется поместить на объект 3-D.Gets or sets the 2-D visual to be placed on the 3-D object.

Visual3DChildrenCount Visual3DChildrenCount Visual3DChildrenCount Visual3DChildrenCount

Получает число дочерних элементов для объекта Visual3D.Gets the number of child elements for the Visual3D object.

(Inherited from Visual3D)
Visual3DModel Visual3DModel Visual3DModel Visual3DModel

Получает или задает объект Model3D для отображения.Gets or sets the Model3D object to render.

(Inherited from Visual3D)

Присоединенные свойства

IsVisualHostMaterial IsVisualHostMaterial IsVisualHostMaterial IsVisualHostMaterial

Получает или задает значение, показывающее, должен ли материал быть интерактивным.Gets or sets a value that specifies whether a material should be interactive.

Методы

AddVisual3DChild(Visual3D) AddVisual3DChild(Visual3D) AddVisual3DChild(Visual3D) AddVisual3DChild(Visual3D)

Определяет связь "родитель-потомок" между двумя визуальными объектами 3-D.Defines the parent-child relationship between two 3-D visuals.

(Inherited from Visual3D)
ApplyAnimationClock(DependencyProperty, AnimationClock) ApplyAnimationClock(DependencyProperty, AnimationClock) ApplyAnimationClock(DependencyProperty, AnimationClock) ApplyAnimationClock(DependencyProperty, AnimationClock)

Применяет результат заданного объекта AnimationClock к указанному свойству зависимостей.Applies the effect of a given AnimationClock to a given dependency property.

(Inherited from Visual3D)
ApplyAnimationClock(DependencyProperty, AnimationClock, HandoffBehavior) ApplyAnimationClock(DependencyProperty, AnimationClock, HandoffBehavior) ApplyAnimationClock(DependencyProperty, AnimationClock, HandoffBehavior) ApplyAnimationClock(DependencyProperty, AnimationClock, HandoffBehavior)

Применяет эффект указанного объекта AnimationClock к указанному свойству зависимостей.Applies the effect of a given AnimationClock to a given dependency property. Эффект нового объекта AnimationClock на любых текущих анимациях определяется значением параметра handoffBehavior.The effect of the new AnimationClock on any current animations is determined by the value of the handoffBehavior parameter.

(Inherited from Visual3D)
BeginAnimation(DependencyProperty, AnimationTimeline) BeginAnimation(DependencyProperty, AnimationTimeline) BeginAnimation(DependencyProperty, AnimationTimeline) BeginAnimation(DependencyProperty, AnimationTimeline)

Инициирует последовательность анимации для объекта DependencyProperty на базе заданного объекта AnimationTimeline.Initiates an animation sequence for the DependencyProperty object, based on the specified AnimationTimeline.

(Inherited from Visual3D)
BeginAnimation(DependencyProperty, AnimationTimeline, HandoffBehavior) BeginAnimation(DependencyProperty, AnimationTimeline, HandoffBehavior) BeginAnimation(DependencyProperty, AnimationTimeline, HandoffBehavior) BeginAnimation(DependencyProperty, AnimationTimeline, HandoffBehavior)

Инициирует последовательность анимации для объекта DependencyProperty на основе заданных объектов AnimationTimeline и HandoffBehavior.Initiates an animation sequence for the DependencyProperty object, based on both the specified AnimationTimeline and HandoffBehavior.

(Inherited from Visual3D)
CheckAccess() CheckAccess() CheckAccess() CheckAccess()

Определяет, имеет ли вызывающий поток доступ к этому DispatcherObject.Determines whether the calling thread has access to this DispatcherObject.

(Inherited from DispatcherObject)
ClearValue(DependencyProperty) ClearValue(DependencyProperty) ClearValue(DependencyProperty) ClearValue(DependencyProperty)

Очищает локальное значение свойства.Clears the local value of a property. Очищаемое свойство задается идентификатором DependencyProperty.The property to be cleared is specified by a DependencyProperty identifier.

(Inherited from DependencyObject)
ClearValue(DependencyPropertyKey) ClearValue(DependencyPropertyKey) ClearValue(DependencyPropertyKey) ClearValue(DependencyPropertyKey)

Очищает локальное значение свойства, доступного только для чтения.Clears the local value of a read-only property. Очищаемое свойство задается объектом DependencyPropertyKey.The property to be cleared is specified by a DependencyPropertyKey.

(Inherited from DependencyObject)
CoerceValue(DependencyProperty) CoerceValue(DependencyProperty) CoerceValue(DependencyProperty) CoerceValue(DependencyProperty)

Приводит значение указанного свойства зависимостей.Coerces the value of the specified dependency property. Это осуществляется путем вызова какой-либо функции CoerceValueCallback, указанной в метаданных свойства зависимостей, которое существует в вызывающем объекте DependencyObject.This is accomplished by invoking any CoerceValueCallback function specified in property metadata for the dependency property as it exists on the calling DependencyObject.

(Inherited from DependencyObject)
Equals(Object) Equals(Object) Equals(Object) Equals(Object)

Определяет, является ли указанный DependencyObject эквивалентом текущего DependencyObject.Determines whether a provided DependencyObject is equivalent to the current DependencyObject.

(Inherited from DependencyObject)
FindCommonVisualAncestor(DependencyObject) FindCommonVisualAncestor(DependencyObject) FindCommonVisualAncestor(DependencyObject) FindCommonVisualAncestor(DependencyObject)

Возвращает общего предка визуального объекта и другой указанный виртуальный объект.Returns the common ancestor of the visual object and another specified visual object.

(Inherited from Visual3D)
GetAnimationBaseValue(DependencyProperty) GetAnimationBaseValue(DependencyProperty) GetAnimationBaseValue(DependencyProperty) GetAnimationBaseValue(DependencyProperty)

Возвращает базовое значение указанного объекта DependencyProperty.Retrieves the base value of the specified DependencyProperty object.

(Inherited from Visual3D)
GetHashCode() GetHashCode() GetHashCode() GetHashCode()

Получает хэш-код для данного объекта DependencyObject.Gets a hash code for this DependencyObject.

(Inherited from DependencyObject)
GetIsVisualHostMaterial(Material) GetIsVisualHostMaterial(Material) GetIsVisualHostMaterial(Material) GetIsVisualHostMaterial(Material)

Получает значение присоединенного свойства IsVisualHostMaterial для указанного элемента UIElement.Gets the value of the IsVisualHostMaterial attached property for a specified UIElement.

GetLocalValueEnumerator() GetLocalValueEnumerator() GetLocalValueEnumerator() GetLocalValueEnumerator()

Создает специализированный перечислитель для определения свойств зависимостей, которые локально установили значения для данного DependencyObject.Creates a specialized enumerator for determining which dependency properties have locally set values on this DependencyObject.

(Inherited from DependencyObject)
GetType() GetType() GetType() GetType()

Возвращает объект Type для текущего экземпляра.Gets the Type of the current instance.

(Inherited from Object)
GetValue(DependencyProperty) GetValue(DependencyProperty) GetValue(DependencyProperty) GetValue(DependencyProperty)

Возвращает текущее действующее значение свойства зависимостей в этом экземпляре DependencyObject.Returns the current effective value of a dependency property on this instance of a DependencyObject.

(Inherited from DependencyObject)
GetVisual3DChild(Int32) GetVisual3DChild(Int32) GetVisual3DChild(Int32) GetVisual3DChild(Int32)

Возвращает указанный объект Visual3D в родительскую коллекцию Visual3DCollection.Returns the specified Visual3D in the parent Visual3DCollection.

(Inherited from Visual3D)
InvalidateProperty(DependencyProperty) InvalidateProperty(DependencyProperty) InvalidateProperty(DependencyProperty) InvalidateProperty(DependencyProperty)

Повторно вычисляет действующее значение для указанного свойства зависимостейRe-evaluates the effective value for the specified dependency property

(Inherited from DependencyObject)
IsAncestorOf(DependencyObject) IsAncestorOf(DependencyObject) IsAncestorOf(DependencyObject) IsAncestorOf(DependencyObject)

Определяет, является ли визуальный объект предком потомка визуального объекта.Determines whether the visual object is an ancestor of the descendant visual object.

(Inherited from Visual3D)
IsDescendantOf(DependencyObject) IsDescendantOf(DependencyObject) IsDescendantOf(DependencyObject) IsDescendantOf(DependencyObject)

Определяет, является ли визуальный объект потомком для предка визуального объекта.Determines whether the visual object is a descendant of the ancestor visual object.

(Inherited from Visual3D)
MemberwiseClone() MemberwiseClone() MemberwiseClone() MemberwiseClone()

Создает неполную копию текущего объекта Object.Creates a shallow copy of the current Object.

(Inherited from Object)
OnPropertyChanged(DependencyPropertyChangedEventArgs) OnPropertyChanged(DependencyPropertyChangedEventArgs) OnPropertyChanged(DependencyPropertyChangedEventArgs) OnPropertyChanged(DependencyPropertyChangedEventArgs)

Вызывается каждый раз, когда обновляется действительное значение любого свойства зависимостей для данного DependencyObject.Invoked whenever the effective value of any dependency property on this DependencyObject has been updated. Конкретное свойство зависимости, которое изменилось, сообщается в данных события.The specific dependency property that changed is reported in the event data.

(Inherited from DependencyObject)
OnVisualChildrenChanged(DependencyObject, DependencyObject) OnVisualChildrenChanged(DependencyObject, DependencyObject) OnVisualChildrenChanged(DependencyObject, DependencyObject) OnVisualChildrenChanged(DependencyObject, DependencyObject)

Вызывается при изменении коллекции Visual3DCollection визуального объекта.Called when the Visual3DCollection of the visual object is modified.

(Inherited from Visual3D)
OnVisualParentChanged(DependencyObject) OnVisualParentChanged(DependencyObject) OnVisualParentChanged(DependencyObject) OnVisualParentChanged(DependencyObject)

Вызывается, если изменяется родительский объект визуального объекта 3-D.Called when the parent of the 3-D visual object is changed.

(Inherited from Visual3D)
ReadLocalValue(DependencyProperty) ReadLocalValue(DependencyProperty) ReadLocalValue(DependencyProperty) ReadLocalValue(DependencyProperty)

Возвращает локальное значение свойства зависимостей, если таковое существует.Returns the local value of a dependency property, if it exists.

(Inherited from DependencyObject)
RemoveVisual3DChild(Visual3D) RemoveVisual3DChild(Visual3D) RemoveVisual3DChild(Visual3D) RemoveVisual3DChild(Visual3D)

Удаляет связь "родитель-потомок" между двумя визуальными объектами 3-D.Removes the parent-child relationship between two 3-D visuals.

(Inherited from Visual3D)
SetCurrentValue(DependencyProperty, Object) SetCurrentValue(DependencyProperty, Object) SetCurrentValue(DependencyProperty, Object) SetCurrentValue(DependencyProperty, Object)

Задает значение свойства зависимостей, не меняя источник значения.Sets the value of a dependency property without changing its value source.

(Inherited from DependencyObject)
SetIsVisualHostMaterial(Material, Boolean) SetIsVisualHostMaterial(Material, Boolean) SetIsVisualHostMaterial(Material, Boolean) SetIsVisualHostMaterial(Material, Boolean)

Задает значение присоединенного свойства IsVisualHostMaterial в указанном элементе.Sets the value of the IsVisualHostMaterial attached property to a specified element.

SetValue(DependencyProperty, Object) SetValue(DependencyProperty, Object) SetValue(DependencyProperty, Object) SetValue(DependencyProperty, Object)

Задает локальное значение свойства зависимостей, указанного идентификатором этого свойства.Sets the local value of a dependency property, specified by its dependency property identifier.

(Inherited from DependencyObject)
SetValue(DependencyPropertyKey, Object) SetValue(DependencyPropertyKey, Object) SetValue(DependencyPropertyKey, Object) SetValue(DependencyPropertyKey, Object)

Задает локальное значение свойства зависимости только для чтения, определяемое идентификатором DependencyPropertyKey свойства зависимостей.Sets the local value of a read-only dependency property, specified by the DependencyPropertyKey identifier of the dependency property.

(Inherited from DependencyObject)
ShouldSerializeProperty(DependencyProperty) ShouldSerializeProperty(DependencyProperty) ShouldSerializeProperty(DependencyProperty) ShouldSerializeProperty(DependencyProperty)

Возвращает значение, которое указывает, следует ли процессам сериализации выполнять сериализацию значения для предоставленного свойства зависимостей.Returns a value that indicates whether serialization processes should serialize the value for the provided dependency property.

(Inherited from DependencyObject)
ToString() ToString() ToString() ToString()

Возвращает строку, представляющую текущий объект.Returns a string that represents the current object.

(Inherited from Object)
TransformToAncestor(Visual) TransformToAncestor(Visual) TransformToAncestor(Visual) TransformToAncestor(Visual)

Возвращает преобразование, которое может использоваться для преобразования координат из этого объекта Visual3D к заданному предку Visual объекта.Returns a transform that can be used to transform coordinates from this Visual3D object to the specified Visual ancestor of the object.

(Inherited from Visual3D)
TransformToAncestor(Visual3D) TransformToAncestor(Visual3D) TransformToAncestor(Visual3D) TransformToAncestor(Visual3D)

Возвращает преобразование, которое может использоваться для преобразования координат из этого объекта Visual3D к заданному предку Visual3D объекта.Returns a transform that can be used to transform coordinates from this Visual3D object to the specified Visual3D ancestor of the object.

(Inherited from Visual3D)
TransformToDescendant(Visual3D) TransformToDescendant(Visual3D) TransformToDescendant(Visual3D) TransformToDescendant(Visual3D)

Возвращает преобразование, которое может использоваться для преобразования координат из этого объекта Visual3D к заданному предку Visual3D объекта.Returns a transform that can be used to transform coordinates from this Visual3D object to the specified Visual3D descent object.

(Inherited from Visual3D)
VerifyAccess() VerifyAccess() VerifyAccess() VerifyAccess()

Обеспечивает наличие у вызывающего потока доступ к этому DispatcherObject.Enforces that the calling thread has access to this DispatcherObject.

(Inherited from DispatcherObject)

Применяется к