ModelUIElement3D 類別
定義
重要
部分資訊涉及發行前產品，在發行之前可能會有大幅修改。 Microsoft 對此處提供的資訊，不做任何明確或隱含的瑕疵擔保。
轉譯支援輸入、焦點 (Focus) 及事件的 3D 模型。
public ref class ModelUIElement3D sealed : System::Windows::UIElement3D[System.Windows.Markup.ContentProperty("Model")]
public sealed class ModelUIElement3D : System.Windows.UIElement3D[<System.Windows.Markup.ContentProperty("Model")>]
type ModelUIElement3D = class
inherit UIElement3DPublic NotInheritable Class ModelUIElement3D
Inherits UIElement3D- 繼承
- 屬性
範例
下列範例示範如何使用 類別建立兩個 ModelUIElement3D Cube：
<Viewport3D>
<Viewport3D.Camera>
<PerspectiveCamera Position="8,3,0" LookDirection="-8,-3,0" />
</Viewport3D.Camera>
<!-- The container has the two cubes as its children -->
<ContainerUIElement3D MouseDown="ContainerMouseDown">
<ContainerUIElement3D.Transform>
<RotateTransform3D>
<RotateTransform3D.Rotation>
<AxisAngleRotation3D x:Name="containerRotation" Axis="0, 1, 0" Angle="0" />
</RotateTransform3D.Rotation>
</RotateTransform3D>
</ContainerUIElement3D.Transform>
<!-- Cube 1 -->
<ModelUIElement3D MouseDown="Cube1MouseDown">
<ModelUIElement3D.Transform>
<TranslateTransform3D OffsetZ="1.5" />
</ModelUIElement3D.Transform>
<ModelUIElement3D.Model>
<GeometryModel3D Geometry="{StaticResource CubeMesh}">
<GeometryModel3D.Material>
<DiffuseMaterial x:Name="cube1Material" Brush="Blue" />
</GeometryModel3D.Material>
</GeometryModel3D>
</ModelUIElement3D.Model>
</ModelUIElement3D>
<!-- Cube 2 -->
<ModelUIElement3D MouseDown="Cube2MouseDown">
<ModelUIElement3D.Transform>
<TranslateTransform3D OffsetZ="-1.5" />
</ModelUIElement3D.Transform>
<ModelUIElement3D.Model>
<GeometryModel3D Geometry="{StaticResource CubeMesh}">
<GeometryModel3D.Material>
<DiffuseMaterial x:Name="cube2Material" Brush="Green" />
</GeometryModel3D.Material>
</GeometryModel3D>
</ModelUIElement3D.Model>
</ModelUIElement3D>
</ContainerUIElement3D>
<!-- Lights -->
<ModelVisual3D>
<ModelVisual3D.Content>
<PointLight Color="White" Position="3, 10, 4" />
</ModelVisual3D.Content>
</ModelVisual3D>
</Viewport3D>
Cube 會透過下列事件處理常式回應滑鼠向下事件：
如需完整的範例，請參閱 在 3D 範例中處理事件 。
備註
ModelUIElement3D.NET Framework 3.5 版引進。 如需詳細資訊，請參閱版本和相依性。
建構函式
| ModelUIElement3D() |
初始化 ContainerUIElement3D 類別的新執行個體。 |
欄位
| ModelProperty |
識別 Model 相依性屬性。 |
屬性
| AllowDrop |
取得或設定此元素是否可以當做拖放操作目標的值。 (繼承來源 UIElement3D) |
| AreAnyTouchesCaptured |
取得值，這個值表示是否至少有一個觸控擷取至這個項目。 (繼承來源 UIElement3D) |
| AreAnyTouchesCapturedWithin |
取得值，這個值表示是否至少有一個觸控擷取至這個項目或其視覺化樹狀結構中的任何子項目。 (繼承來源 UIElement3D) |
| AreAnyTouchesDirectlyOver |
取得值，這個值表示是否至少有一個觸控在這個項目上按下。 (繼承來源 UIElement3D) |
| AreAnyTouchesOver |
取得值，這個值表示是否至少有一個觸控在這個項目或其視覺化樹狀結構中的任何子項目上按下。 (繼承來源 UIElement3D) |
| CommandBindings |
取得與這個項目關聯的 CommandBinding 物件集合。 (繼承來源 UIElement3D) |
| DependencyObjectType |
取得包裝 DependencyObjectType 這個實例 CLR 型別的 。 (繼承來源 DependencyObject) |
| Dispatcher |
取得與這個 Dispatcher 關聯的 DispatcherObject。 (繼承來源 DispatcherObject) |
| Focusable |
取得或設定元素是否能夠接收焦點的值。 (繼承來源 UIElement3D) |
| HasAnimatedProperties |
取得值，這個值表示這個 Visual3D 是否有任何動畫屬性。 (繼承來源 Visual3D) |
| InputBindings |
取得與此元素關聯的輸入繫結集合。 (繼承來源 UIElement3D) |
| IsEnabled |
取得或設定值，指出使用者介面中是否啟用這個專案， (UI) 。 (繼承來源 UIElement3D) |
| IsEnabledCore |
取得值，這個值會成為衍生類別中 IsEnabled 的傳回值。 (繼承來源 UIElement3D) |
| IsFocused |
取得值，決定這個項目是否具有邏輯焦點。 (繼承來源 UIElement3D) |
| IsHitTestVisible |
取得或設定宣告此元素是否可以從其呈現內容的某些部分傳回，作為點擊測試結果的值。 (繼承來源 UIElement3D) |
| IsInputMethodEnabled |
取得值，指出是否啟用輸入法編輯器 (輸入法) 等輸入法系統，以處理這個專案的輸入。 (繼承來源 UIElement3D) |
| IsKeyboardFocused |
取得值，指出這個項目是否具有鍵盤焦點。 (繼承來源 UIElement3D) |
| IsKeyboardFocusWithin |
取得值，表示鍵盤焦點是否在項目或其視覺化樹狀結構子項目內的任何位置。 (繼承來源 UIElement3D) |
| IsMouseCaptured |
取得值，指出是否將滑鼠擷取至這個項目。 (繼承來源 UIElement3D) |
| IsMouseCaptureWithin |
取得值，這個值決定滑鼠擷取是由這個項目持有，還是由其視覺化樹狀中的子項目持有。 (繼承來源 UIElement3D) |
| IsMouseDirectlyOver |
取得值，指出滑鼠指標位置是否與點擊測試結果對應，該結果會將複合項目納入考量。 (繼承來源 UIElement3D) |
| IsMouseOver |
取得值，指出滑鼠指標是否在這個項目上方 (包括視覺化樹狀中的子項目)。 (繼承來源 UIElement3D) |
| IsSealed |
取得值，這個值表示此執行個體目前是否已密封 (唯讀)。 (繼承來源 DependencyObject) |
| IsStylusCaptured |
取得值，指出這個項目是否擷取手寫筆。 (繼承來源 UIElement3D) |
| IsStylusCaptureWithin |
取得值，這個值決定手寫筆擷取是由這個項目持有，還是由項目範圍及其視覺化樹狀結構中的項目持有。 (繼承來源 UIElement3D) |
| IsStylusDirectlyOver |
取得值，指出手寫筆位置是否與點擊測試結果相對應，該結果會將複合項目納入考量。 (繼承來源 UIElement3D) |
| IsStylusOver |
取得值，指出手寫筆游標是否位在這個項目上方 (包括視覺子項目)。 (繼承來源 UIElement3D) |
| IsVisible |
取得值，指出這個元素是否顯示在使用者介面 (UI) 中。 (繼承來源 UIElement3D) |
| Model |
取得或設定要呈現的 Model3D。 |
| TouchesCaptured |
取得已擷取至這個項目的所有觸控裝置。 (繼承來源 UIElement3D) |
| TouchesCapturedWithin |
取得已擷取至這個項目或其視覺化樹狀結構中之任何子項目的所有觸控裝置。 (繼承來源 UIElement3D) |
| TouchesDirectlyOver |
取得在這個項目上停留的所有觸控裝置。 (繼承來源 UIElement3D) |
| TouchesOver |
取得在這個項目或其視覺化樹狀結構中之任何子項目上停留的所有觸控裝置。 (繼承來源 UIElement3D) |
| Transform |
取得或設定套用至 3D 物件的轉換。 (繼承來源 Visual3D) |
| Visibility |
取得或設定使用者介面 (UI) 這個專案的可見度。 (繼承來源 UIElement3D) |
| Visual3DChildrenCount |
取得 Visual3D 物件的子項目數目。 (繼承來源 Visual3D) |
| Visual3DModel |
取得或設定要轉譯之 Model3D 物件的名稱。 (繼承來源 Visual3D) |
方法
事件
| DragEnter |
輸入系統報告其下以此項目作為拖曳目標的拖曳事件時發生。 (繼承來源 UIElement3D) |
| DragLeave |
輸入系統報告其下以此項目作為拖曳來源的拖曳事件時發生。 (繼承來源 UIElement3D) |
| DragOver |
在輸入系統回報以此項目作為可能置放目標的基礎拖曳事件時發生。 (繼承來源 UIElement3D) |
| Drop |
輸入系統報告其下以這個項目作為置放目標的置放事件時發生。 (繼承來源 UIElement3D) |
| FocusableChanged |
發生於 Focusable 屬性的值變更時。 (繼承來源 UIElement3D) |
| GiveFeedback |
輸入系統報告其下牽涉此元素的拖放事件時發生。 (繼承來源 UIElement3D) |
| GotFocus |
此元素取得邏輯焦點時發生。 (繼承來源 UIElement3D) |
| GotKeyboardFocus |
鍵盤以此元素為焦點時發生。 (繼承來源 UIElement3D) |
| GotMouseCapture |
此元素擷取滑鼠時發生。 (繼承來源 UIElement3D) |
| GotStylusCapture |
此元素擷取手寫筆時發生。 (繼承來源 UIElement3D) |
| GotTouchCapture |
當觸控擷取至這個項目時發生。 (繼承來源 UIElement3D) |
| IsEnabledChanged |
當這個項目的 IsEnabled 屬性值變更時發生。 (繼承來源 UIElement3D) |
| IsHitTestVisibleChanged |
當這個項目的 IsHitTestVisible 相依性屬性值變更時發生。 (繼承來源 UIElement3D) |
| IsKeyboardFocusedChanged |
當這個項目的 IsKeyboardFocused 屬性值變更時發生。 (繼承來源 UIElement3D) |
| IsKeyboardFocusWithinChanged |
當這個項目的 IsKeyboardFocusWithin 屬性值變更時發生。 (繼承來源 UIElement3D) |
| IsMouseCapturedChanged |
當這個項目的 IsMouseCaptured 屬性值變更時發生。 (繼承來源 UIElement3D) |
| IsMouseCaptureWithinChanged |
當這個項目的 IsMouseCaptureWithin 屬性值變更時發生。 (繼承來源 UIElement3D) |
| IsMouseDirectlyOverChanged |
當這個項目的 IsMouseDirectlyOver 屬性值變更時發生。 (繼承來源 UIElement3D) |
| IsStylusCapturedChanged |
當這個項目的 IsStylusCaptured 屬性值變更時發生。 (繼承來源 UIElement3D) |
| IsStylusCaptureWithinChanged |
當這個項目的 IsStylusCaptureWithin 屬性值變更時發生。 (繼承來源 UIElement3D) |
| IsStylusDirectlyOverChanged |
當這個項目的 IsStylusDirectlyOver 屬性值變更時發生。 (繼承來源 UIElement3D) |
| IsVisibleChanged |
當這個項目的 IsVisible 屬性值變更時發生。 (繼承來源 UIElement3D) |
| KeyDown |
鍵盤以此元素為焦點且按下按鍵時發生。 (繼承來源 UIElement3D) |
| KeyUp |
鍵盤以此元素為焦點且放開按鍵時發生。 (繼承來源 UIElement3D) |
| LostFocus |
此元素失去邏輯焦點時發生。 (繼承來源 UIElement3D) |
| LostKeyboardFocus |
鍵盤不再以此元素為焦點時發生。 (繼承來源 UIElement3D) |
| LostMouseCapture |
此元素失去滑鼠擷取時發生。 (繼承來源 UIElement3D) |
| LostStylusCapture |
此元素失去手寫筆擷取時發生。 (繼承來源 UIElement3D) |
| LostTouchCapture |
當這個項目失去觸控擷取時發生。 (繼承來源 UIElement3D) |
| MouseDown |
指標在此元素上方且按下任何滑鼠按鈕時發生。 (繼承來源 UIElement3D) |
| MouseEnter |
滑鼠指標進入此元素的邊界時發生。 (繼承來源 UIElement3D) |
| MouseLeave |
滑鼠指標離開此元素的邊界時發生。 (繼承來源 UIElement3D) |
| MouseLeftButtonDown |
滑鼠指標在此元素上方且按下滑鼠左按鈕時發生。 (繼承來源 UIElement3D) |
| MouseLeftButtonUp |
滑鼠指標在此元素上方且放開滑鼠左按鈕時發生。 (繼承來源 UIElement3D) |
| MouseMove |
滑鼠指標在此元素上方移動時發生。 (繼承來源 UIElement3D) |
| MouseRightButtonDown |
滑鼠指標在此元素上方且按下滑鼠右按鈕時發生。 (繼承來源 UIElement3D) |
| MouseRightButtonUp |
滑鼠指標在此元素上方且放開滑鼠右按鈕時發生。 (繼承來源 UIElement3D) |
| MouseUp |
在此元素上方放開任何滑鼠按鈕時發生。 (繼承來源 UIElement3D) |
| MouseWheel |
滑鼠指標在此元素上方且使用者滾動滑鼠滾輪時發生。 (繼承來源 UIElement3D) |
| PreviewDragEnter |
輸入系統報告其下以此項目作為拖曳目標的拖曳事件時發生。 (繼承來源 UIElement3D) |
| PreviewDragLeave |
輸入系統報告其下以此項目作為拖曳來源的拖曳事件時發生。 (繼承來源 UIElement3D) |
| PreviewDragOver |
在輸入系統回報以此項目作為可能置放目標的基礎拖曳事件時發生。 (繼承來源 UIElement3D) |
| PreviewDrop |
輸入系統報告其下以這個項目作為置放目標的置放事件時發生。 (繼承來源 UIElement3D) |
| PreviewGiveFeedback |
拖放操作開始時發生。 (繼承來源 UIElement3D) |
| PreviewGotKeyboardFocus |
鍵盤以此元素為焦點時發生。 (繼承來源 UIElement3D) |
| PreviewKeyDown |
鍵盤以此元素為焦點且按下按鍵時發生。 (繼承來源 UIElement3D) |
| PreviewKeyUp |
鍵盤以此元素為焦點且放開按鍵時發生。 (繼承來源 UIElement3D) |
| PreviewLostKeyboardFocus |
鍵盤不再以此元素為焦點時發生。 (繼承來源 UIElement3D) |
| PreviewMouseDown |
指標在此元素上方且按下任何滑鼠按鈕時發生。 (繼承來源 UIElement3D) |
| PreviewMouseLeftButtonDown |
滑鼠指標在此元素上方且按下滑鼠左按鈕時發生。 (繼承來源 UIElement3D) |
| PreviewMouseLeftButtonUp |
滑鼠指標在此元素上方且放開滑鼠左按鈕時發生。 (繼承來源 UIElement3D) |
| PreviewMouseMove |
滑鼠指標在此元素上方且移動滑鼠指標時發生。 (繼承來源 UIElement3D) |
| PreviewMouseRightButtonDown |
滑鼠指標在此元素上方且按下滑鼠右按鈕時發生。 (繼承來源 UIElement3D) |
| PreviewMouseRightButtonUp |
滑鼠指標在此元素上方且放開滑鼠右按鈕時發生。 (繼承來源 UIElement3D) |
| PreviewMouseUp |
滑鼠指標在此元素上方且放開任何滑鼠按鈕時發生。 (繼承來源 UIElement3D) |
| PreviewMouseWheel |
滑鼠指標在此元素上方且使用者滾動滑鼠滾輪時發生。 (繼承來源 UIElement3D) |
| PreviewQueryContinueDrag |
拖放操作期間，鍵盤或滑鼠按鈕狀態變更時發生。 (繼承來源 UIElement3D) |
| PreviewStylusButtonDown |
手寫筆指標在此元素上方且按下手寫筆按鈕時發生。 (繼承來源 UIElement3D) |
| PreviewStylusButtonUp |
手寫筆指標在此元素上方且放開手寫筆按鈕時發生。 (繼承來源 UIElement3D) |
| PreviewStylusDown |
手寫筆在此項目上方且碰觸數位板時發生。 (繼承來源 UIElement3D) |
| PreviewStylusInAirMove |
手寫筆在項目上方移動，但沒有真正碰觸數位板時發生。 (繼承來源 UIElement3D) |
| PreviewStylusInRange |
手寫筆在此項目上方，且夠靠近數位板而被偵測到時發生。 (繼承來源 UIElement3D) |
| PreviewStylusMove |
手寫筆在項目上方移動時發生。 手寫筆必須在受到數位板偵測時移動才能引發此事件，否則會改為引發 PreviewStylusInAirMove。 (繼承來源 UIElement3D) |
| PreviewStylusOutOfRange |
手寫筆遠離數位板而無法被偵測到時發生。 (繼承來源 UIElement3D) |
| PreviewStylusSystemGesture |
使用者執行其中一種手寫筆筆勢時發生。 (繼承來源 UIElement3D) |
| PreviewStylusUp |
手寫筆在此項目上方，且使用者將手寫筆舉起離開數位板時發生。 (繼承來源 UIElement3D) |
| PreviewTextInput |
此元素以一種與裝置無關的方式取得文字時發生。 (繼承來源 UIElement3D) |
| PreviewTouchDown |
手指在這個項目上方且在螢幕上觸控時發生。 (繼承來源 UIElement3D) |
| PreviewTouchMove |
手指在這個項目上方且在螢幕上移動時發生。 (繼承來源 UIElement3D) |
| PreviewTouchUp |
手指在這個項目上方且離開螢幕時發生。 (繼承來源 UIElement3D) |
| QueryContinueDrag |
拖放操作期間，鍵盤或滑鼠按鈕狀態變更時發生。 (繼承來源 UIElement3D) |
| QueryCursor |
要求顯示游標時發生。 每當滑鼠指標移動至新位置時，都會引發此事件，這意謂游標物件可能會根據其新位置而變更。 (繼承來源 UIElement3D) |
| StylusButtonDown |
手寫筆指標在此元素上方且按下手寫筆按鈕時發生。 (繼承來源 UIElement3D) |
| StylusButtonUp |
手寫筆指標在此元素上方且放開手寫筆按鈕時發生。 (繼承來源 UIElement3D) |
| StylusDown |
手寫筆在此項目上方且碰觸數位板時發生。 (繼承來源 UIElement3D) |
| StylusEnter |
手寫筆進入此元素的邊界時發生。 (繼承來源 UIElement3D) |
| StylusInAirMove |
手寫筆在項目上方移動，但沒有真正碰觸數位板時發生。 (繼承來源 UIElement3D) |
| StylusInRange |
手寫筆在此項目上方，且夠靠近數位板而被偵測到時發生。 (繼承來源 UIElement3D) |
| StylusLeave |
手寫筆離開元素的邊界時發生。 (繼承來源 UIElement3D) |
| StylusMove |
當手寫筆移至此項目上方時發生。 手寫筆在數位板上必須移動才會引發這個事件。 否則，會改為引發 StylusInAirMove。 (繼承來源 UIElement3D) |
| StylusOutOfRange |
手寫筆在此項目上方，且遠離數位板而無法被偵測到時發生。 (繼承來源 UIElement3D) |
| StylusSystemGesture |
使用者執行其中一種手寫筆筆勢時發生。 (繼承來源 UIElement3D) |
| StylusUp |
手寫筆在此項目上方，且使用者將手寫筆舉起離開數位板時發生。 (繼承來源 UIElement3D) |
| TextInput |
此元素以一種與裝置無關的方式取得文字時發生。 (繼承來源 UIElement3D) |
| TouchDown |
手指在這個項目上方且在螢幕上觸控時發生。 (繼承來源 UIElement3D) |
| TouchEnter |
當觸控從這個項目的界限外部移至內部時發生。 (繼承來源 UIElement3D) |
| TouchLeave |
當觸控從這個項目的界限內部移至外部時發生。 (繼承來源 UIElement3D) |
| TouchMove |
手指在這個項目上方且在螢幕上移動時發生。 (繼承來源 UIElement3D) |
| TouchUp |
手指在這個項目上方且離開螢幕時發生。 (繼承來源 UIElement3D) |
適用於
另請參閱
意見反應
即將登場：在 2024 年，我們將逐步淘汰 GitHub 問題作為內容的意見反應機制，並將它取代為新的意見反應系統。 如需詳細資訊，請參閱：https://aka.ms/ContentUserFeedback。
提交並檢視相關的意見反應