Viewport2DVisual3D Класс

Определение

Прорисовывает дочерний объект 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.Initializes a new instance of the Viewport2DVisual3D class.

Поля

CacheModeProperty

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

GeometryProperty

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

IsVisualHostMaterialProperty

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

MaterialProperty

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

VisualProperty

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

Свойства

CacheMode

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

DependencyObjectType

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

(Унаследовано от DependencyObject)
Dispatcher

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

(Унаследовано от DispatcherObject)
Geometry

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

HasAnimatedProperties

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

(Унаследовано от Visual3D)
IsSealed

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

(Унаследовано от DependencyObject)
Material

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

Transform

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

(Унаследовано от Visual3D)
Visual

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

Visual3DChildrenCount

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

(Унаследовано от Visual3D)
Visual3DModel

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

(Унаследовано от Visual3D)

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

IsVisualHostMaterial

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

Методы

AddVisual3DChild(Visual3D)

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

(Унаследовано от Visual3D)
ApplyAnimationClock(DependencyProperty, AnimationClock)

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

(Унаследовано от Visual3D)
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.

(Унаследовано от Visual3D)
BeginAnimation(DependencyProperty, AnimationTimeline)

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

(Унаследовано от Visual3D)
BeginAnimation(DependencyProperty, AnimationTimeline, HandoffBehavior)

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

(Унаследовано от Visual3D)
CheckAccess()

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

(Унаследовано от DispatcherObject)
ClearValue(DependencyProperty)

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

(Унаследовано от DependencyObject)
ClearValue(DependencyPropertyKey)

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

(Унаследовано от DependencyObject)
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.

(Унаследовано от DependencyObject)
Equals(Object)

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

(Унаследовано от DependencyObject)
FindCommonVisualAncestor(DependencyObject)

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

(Унаследовано от Visual3D)
GetAnimationBaseValue(DependencyProperty)

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

(Унаследовано от Visual3D)
GetHashCode()

Возвращает хэш-код для данного объекта DependencyObject.Gets a hash code for this DependencyObject.

(Унаследовано от DependencyObject)
GetIsVisualHostMaterial(Material)

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

GetLocalValueEnumerator()

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

(Унаследовано от DependencyObject)
GetType()

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

(Унаследовано от Object)
GetValue(DependencyProperty)

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

(Унаследовано от DependencyObject)
GetVisual3DChild(Int32)

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

(Унаследовано от Visual3D)
InvalidateProperty(DependencyProperty)

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

(Унаследовано от DependencyObject)
IsAncestorOf(DependencyObject)

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

(Унаследовано от Visual3D)
IsDescendantOf(DependencyObject)

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

(Унаследовано от Visual3D)
MemberwiseClone()

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

(Унаследовано от Object)
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.

(Унаследовано от DependencyObject)
OnVisualChildrenChanged(DependencyObject, DependencyObject)

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

(Унаследовано от Visual3D)
OnVisualParentChanged(DependencyObject)

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

(Унаследовано от Visual3D)
ReadLocalValue(DependencyProperty)

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

(Унаследовано от DependencyObject)
RemoveVisual3DChild(Visual3D)

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

(Унаследовано от Visual3D)
SetCurrentValue(DependencyProperty, Object)

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

(Унаследовано от DependencyObject)
SetIsVisualHostMaterial(Material, Boolean)

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

SetValue(DependencyProperty, Object)

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

(Унаследовано от DependencyObject)
SetValue(DependencyPropertyKey, Object)

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

(Унаследовано от DependencyObject)
ShouldSerializeProperty(DependencyProperty)

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

(Унаследовано от DependencyObject)
ToString()

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

(Унаследовано от Object)
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.

(Унаследовано от 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.

(Унаследовано от 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.

(Унаследовано от Visual3D)
VerifyAccess()

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

(Унаследовано от DispatcherObject)

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