ModelVisual3D ModelVisual3D ModelVisual3D ModelVisual3D Class

정의

Visual3D 개체를 렌더링하는 Model3D를 제공합니다.Provides 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
상속
특성
구현

예제

다음 예제에서는 태그에서 ModelVisual3D의 인스턴스를 보여 줍니다.The following example shows an instance of ModelVisual3D in markup. myTeapot 참조는 MeshGeometry3D 외부적으로 정의 합니다.myTeapot refers to a MeshGeometry3D defined externally. 자신만의 모든 기 하 도형을 대체할 수 있습니다.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>

설명

서비스 및 적중 테스트를 포함 하는 모든 시각적 개체에 공통 된 속성 좌표 변환, 경계 상자 계산 등을 제공 합니다.Provides services and properties that are common to all visual objects, including hit-testing, coordinate transformation, and bounding-box calculations.

합니다 ModelVisual3D 클래스에는 Children 의 트리 구조를 구축할 수 있도록 속성 ModelVisual3D 개체입니다.The ModelVisual3D class has a Children property that enables you to build a tree structure of ModelVisual3D objects.

ModelVisual3D 개체는 장면 노드도 최적화 됩니다.ModelVisual3D objects are optimized as scene nodes. 예를 들어 범위를 캐시 합니다.For example, they cache bounds. 사용할 때마다 ModelVisual3D 장면 내에서 개체의 고유 인스턴스에 대 한 개체입니다.Whenever you can, use ModelVisual3D objects for unique instances of objects within your scene. 이 사용량의 대조 됩니다 Model3D 개체를 공유 하 고 다시 사용 하도록 최적화 된 간단한 개체입니다.This usage contrasts with that of Model3D objects, which are lightweight objects that are optimized to be shared and reused. 예를 들어 사용을 Model3D ; 자동차의 모델을 작성 하 고 10 개를 사용 하 여 개체 ModelVisual3D 장면에 10 개의 자동차를 배치 하는 개체입니다.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.

생성자

ModelVisual3D() ModelVisual3D() ModelVisual3D() ModelVisual3D()

ModelVisual3D 클래스의 새 인스턴스를 초기화합니다.Initializes a new instance of the ModelVisual3D class.

필드

ContentProperty ContentProperty ContentProperty ContentProperty

Content 종속성 속성을 식별합니다.Identifies the Content dependency property.

TransformProperty TransformProperty TransformProperty TransformProperty

Transform 종속성 속성을 식별합니다.Identifies the Transform dependency property.

속성

Children Children Children Children

자식 Visual3D 개체의 컬렉션을 가져옵니다.Gets a collection of child Visual3D objects.

Content Content Content Content

ModelVisual3D의 콘텐츠를 구성하는 모델을 가져오거나 설정합니다.Gets or sets the model that comprises the content of the ModelVisual3D.

DependencyObjectType DependencyObjectType DependencyObjectType DependencyObjectType

이 인스턴스의 CLRCLR 형식을 래핑하는 DependencyObjectType을 가져옵니다.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)
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)
Transform Transform Transform Transform

ModelVisual3D에 설정된 변환을 가져오거나 설정합니다.Gets or sets the transform set on the ModelVisual3D.

Visual3DChildrenCount Visual3DChildrenCount Visual3DChildrenCount Visual3DChildrenCount

자식 개체 수를 반환합니다.Returns the number of child objects.

Visual3DModel Visual3DModel Visual3DModel Visual3DModel

렌더링할 Model3D 개체를 가져오거나 설정합니다.Gets or sets the Model3D object to render.

(Inherited from Visual3D)

메서드

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

두 3차원 시각적 개체 사이에 부모-자식 관계를 정의합니다.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)

지정된 AnimationTimeline을 기반으로, DependencyProperty 개체의 애니메이션 시퀀스를 시작합니다.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)

지정된 DependencyPropertyAnimationTimeline에 따라 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. 호출하는 DependencyObject에 있으므로 이 작업은 종속성 속성의 속성 메타데이터에 지정된 CoerceValueCallback 함수를 호출하여 수행합니다.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)
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를 반환합니다.Returns the specified Visual3D in the parent collection.

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차원 시각적 개체의 부모가 변경될 때 호출됩니다.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차원 시각적 개체 사이에서 부모-자식 관계를 제거합니다.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)
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)

serialization 프로세스에서 지정된 종속성 속성의 값을 직렬화해야 하는지 여부를 나타내는 값을 반환합니다.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)

명시적 인터페이스 구현

IAddChild.AddChild(Object) IAddChild.AddChild(Object) IAddChild.AddChild(Object) IAddChild.AddChild(Object)

자식 개체를 추가합니다.Adds a child object.

IAddChild.AddText(String) IAddChild.AddText(String) IAddChild.AddText(String) IAddChild.AddText(String)

노드의 텍스트 콘텐츠를 개체에 추가합니다.Adds the text content of a node to the object.

적용 대상