ModelUIElement3D 类
定义
重要
一些信息与预发行产品相关，相应产品在发行之前可能会进行重大修改。 对于此处提供的信息，Microsoft 不作任何明示或暗示的担保。
呈现支持输入、焦点和事件的三维模型。
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 类创建两个多维数据集：
<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>
多维数据集通过以下事件处理程序响应鼠标按下事件：
有关完整示例，请参阅 处理三维示例中的事件 。
注解
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 |
获取或设置应用于三维对象的变换。 (继承自 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。
提交和查看相关反馈