Model3D 類別

定義

命名空間:: System.Windows.Media.Media3D

組件:: PresentationCore.dll

重要

部分資訊涉及發行前產品，在發行之前可能會有大幅修改。 Microsoft 對此處提供的資訊，不做任何明確或隱含的瑕疵擔保。

提供3D模型的功能。

public ref class Model3D abstract : System::Windows::Media::Animation::Animatable, IFormattable

[System.Windows.Localizability(System.Windows.LocalizationCategory.None, Readability=System.Windows.Readability.Unreadable)]
public abstract class Model3D : System.Windows.Media.Animation.Animatable, IFormattable

[<System.Windows.Localizability(System.Windows.LocalizationCategory.None, Readability=System.Windows.Readability.Unreadable)>]
type Model3D = class
    inherit Animatable
    interface IFormattable
    interface DUCE.IResource

[<System.Windows.Localizability(System.Windows.LocalizationCategory.None, Readability=System.Windows.Readability.Unreadable)>]
type Model3D = class
    inherit Animatable
    interface IFormattable

Public MustInherit Class Model3D
Inherits Animatable
Implements IFormattable

繼承: Object

DispatcherObject

DependencyObject

Freezable

Animatable
Model3D

衍生: System.Windows.Media.Media3D.GeometryModel3D

System.Windows.Media.Media3D.Light

System.Windows.Media.Media3D.Model3DGroup

屬性: LocalizabilityAttribute

實作: IFormattable

範例

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

備註

此類物件包括 GeometryModel3D、 Light、 Model3DGroup和。

用這個 ModelVisual3D 類別來渲染 Model3D 物件。你可以用來Model3D組合Model3DGroup物件，形成一個單一模型。你可以在物件間Model3D共享ModelVisual3D物件，讓場景中產生多個實例。

欄位

名稱	Description
TransformProperty	識別 Transform 依賴性質。

屬性

名稱	Description
Bounds	得到， Rect3D 指定了此 Model3D的軸對齊邊界框。
CanFreeze	會得到一個值，表示該物件是否能被設定為不可修改。 (繼承來源 Freezable)
DependencyObjectType	會取得 DependencyObjectType 包裹此實例 CLR 類型的。 (繼承來源 DependencyObject)
Dispatcher	了解 Dispatcher 這與此 DispatcherObject 有關。 (繼承來源 DispatcherObject)
HasAnimatedProperties	會得到一個值，表示是否有一個或多個 AnimationClock 物件與該物件的相依屬性相關聯。 (繼承來源 Animatable)
IsFrozen	會得到一個值，表示該物件目前是否可修改。 (繼承來源 Freezable)
IsSealed	會獲得一個值，表示該實例目前是否封存（唯讀）。 (繼承來源 DependencyObject)
Transform	取得或設定 Transform3D 模型上的集合。

方法

名稱	Description
ApplyAnimationClock(DependencyProperty, AnimationClock, HandoffBehavior)	應用於 AnimationClock 指定的 DependencyProperty。如果該屬性已經被動畫化，則會使用指定的 HandoffBehavior 屬性。 (繼承來源 Animatable)
ApplyAnimationClock(DependencyProperty, AnimationClock)	應用於 AnimationClock 指定的 DependencyProperty。如果該屬性已經被動畫化，則 SnapshotAndReplace 會使用切換行為。 (繼承來源 Animatable)
BeginAnimation(DependencyProperty, AnimationTimeline, HandoffBehavior)	對指定的 DependencyProperty. 動畫會在下一幀渲染時開始。如果指定的屬性已經被動畫化，則會使用指定的 HandoffBehavior 屬性。 (繼承來源 Animatable)
BeginAnimation(DependencyProperty, AnimationTimeline)	對指定的 DependencyProperty. 動畫會在下一幀渲染時開始。如果指定的屬性已經動畫化，則 SnapshotAndReplace 會採用切換行為。 (繼承來源 Animatable)
CheckAccess()	判斷呼叫執行緒是否能存取此 DispatcherObject。 (繼承來源 DispatcherObject)
ClearValue(DependencyProperty)	清算房產的當地價值。要清除的屬性由識別 DependencyProperty 碼指定。 (繼承來源 DependencyObject)
ClearValue(DependencyPropertyKey)	清除只讀屬性的局部值。要清除的屬性由 DependencyPropertyKey指定。 (繼承來源 DependencyObject)
Clone()	建立可修改的克隆， Model3D並製作該物件值的深度複製。在複製依賴屬性時，此方法會複製資源參考與資料綁定（雖然可能不再解析），但不會複製動畫或其當前值。
CloneCore(Freezable)	使用基礎（非動畫）屬性值，將實例複製為指定的 Freezable 複製（深度複製）。 (繼承來源 Freezable)
CloneCurrentValue()	建立該 Model3D 物件的可修改克隆，並製作該物件當前值的深度複製。資源參考、資料綁定與動畫不會被複製;但其當前數值會被複製。
CloneCurrentValueCore(Freezable)	利用目前屬性值，讓實例成為可修改的複製（深度複製）。Freezable (繼承來源 Freezable)
CoerceValue(DependencyProperty)	強制設定指定的依賴性質值。這是透過在屬性CoerceValueCallback中指定的依賴屬性元資料中，呼叫的依賴屬性中的任何DependencyObject函式來達成的。 (繼承來源 DependencyObject)
CreateInstance()	初始化 Freezable 類別的新執行個體。 (繼承來源 Freezable)
CreateInstanceCore()	當在導出類別中實作時，會建立該 Freezable 衍生類別的新實例。 (繼承來源 Freezable)
Equals(Object)	判斷所給的 DependencyObject 是否等同於電流 DependencyObject。 (繼承來源 DependencyObject)
Freeze()	使目前物件無法修改，並將其 IsFrozen 屬性設為 `true`。 (繼承來源 Freezable)
FreezeCore(Boolean)	使此 Animatable 物件不可修改，或決定是否能被不可修改。 (繼承來源 Animatable)
GetAnimationBaseValue(DependencyProperty)	回傳指定的 DependencyProperty非動畫值。 (繼承來源 Animatable)
GetAsFrozen()	使用基礎（非動畫）屬性值建立一個凍結的 Freezable。由於複製是凍結的，任何凍結的子物件都會透過參考被複製。 (繼承來源 Freezable)
GetAsFrozenCore(Freezable)	讓實例成為指定條件 Freezable 的凍結複製，使用基礎（非動畫）屬性值。 (繼承來源 Freezable)
GetCurrentValueAsFrozen()	用目前屬性值建立一個凍結的副本 Freezable 。由於複製是凍結的，任何凍結的子物件都會透過參考被複製。 (繼承來源 Freezable)
GetCurrentValueAsFrozenCore(Freezable)	使當前實例成為指定 Freezable的凍結克隆。如果物件具有動畫相依性屬性，則會複製其目前的動畫值。 (繼承來源 Freezable)
GetHashCode()	會得到一個 DependencyObject雜湊碼。 (繼承來源 DependencyObject)
GetLocalValueEnumerator()	建立專門的枚舉器，用以判斷哪些相依屬性在局部 DependencyObject設定值。 (繼承來源 DependencyObject)
GetType()	取得目前實例的 Type。 (繼承來源 Object)
GetValue(DependencyProperty)	回傳此實例 DependencyObject上依賴屬性的當前有效值。 (繼承來源 DependencyObject)
InvalidateProperty(DependencyProperty)	重新評估指定相依性質的有效值。 (繼承來源 DependencyObject)
MemberwiseClone()	建立目前 Object的淺層複本。 (繼承來源 Object)
OnChanged()	當當前 Freezable 物件被修改時呼叫。 (繼承來源 Freezable)
OnFreezablePropertyChanged(DependencyObject, DependencyObject, DependencyProperty)	此成員支援 Windows Presentation Foundation（WPF）基礎架構，並非直接從您的程式碼中使用。 (繼承來源 Freezable)
OnFreezablePropertyChanged(DependencyObject, DependencyObject)	確保剛設定的資料成員建立 DependencyObjectType 適當的上下文指標。 (繼承來源 Freezable)
OnPropertyChanged(DependencyPropertyChangedEventArgs)	覆DependencyObject寫的OnPropertyChanged(DependencyPropertyChangedEventArgs)實作，也在回應類型中變動的依賴屬性Changed時呼叫任何Freezable處理器。 (繼承來源 Freezable)
ReadLocalValue(DependencyProperty)	回傳依賴屬性的局部值（若存在）。 (繼承來源 DependencyObject)
ReadPreamble()	確保存取 Freezable 的是有效的執行緒。繼 Freezable 承者必須在任何讀取非相依屬性資料成員的資料 API 開頭呼叫此方法。 (繼承來源 Freezable)
SetCurrentValue(DependencyProperty, Object)	設定依賴屬性的值，且不改變其值來源。 (繼承來源 DependencyObject)
SetValue(DependencyProperty, Object)	設定依賴屬性的局部值，並由其依賴屬性識別碼指定。 (繼承來源 DependencyObject)
SetValue(DependencyPropertyKey, Object)	設定只讀相依屬性的本地值，該值由 DependencyPropertyKey 相依屬性的識別碼指定。 (繼承來源 DependencyObject)
ShouldSerializeProperty(DependencyProperty)	回傳一個值，指示序列化程序是否應該將所提供的相依屬性的值序列化。 (繼承來源 DependencyObject)
ToString()	建立 Model3D 的字串表示。
ToString(IFormatProvider)	建立 Model3D 的字串表示。
VerifyAccess()	強制呼叫執行緒能存取此 DispatcherObject。 (繼承來源 DispatcherObject)
WritePostscript()	提升 Changed 事件並 Freezable 調用其 OnChanged() 方法。衍生於的 Freezable 類別應在任何修改未儲存為相依屬性的類別成員的 API 結尾呼叫此方法。 (繼承來源 Freezable)
WritePreamble()	驗證未 Freezable 被凍結，且存取時正從有效的執行緒上下文中存取。 Freezable 繼承者應在任何寫入非相依屬性資料成員的 API 開頭呼叫此方法。 (繼承來源 Freezable)

事件

名稱	Description
Changed	當 Freezable 它所包含的物件被修改時，會發生這種情況。 (繼承來源 Freezable)

明確介面實作

名稱	Description
IFormattable.ToString(String, IFormatProvider)	使用指定的格式，格式化目前實例的值。

適用於

意見反應

此頁面對您有幫助嗎？