ContentElement 类
定义
重要
一些信息与预发行产品相关，相应产品在发行之前可能会进行重大修改。 对于此处提供的信息，Microsoft 不作任何明示或暗示的担保。
为内容元素提供 WPF 核心级基类。 内容元素设计用于流样式显示，它们使用面向标记的直观布局模型和精心设计的简单对象模型。
public ref class ContentElement : System::Windows::DependencyObject, System::Windows::IInputElement, System::Windows::Media::Animation::IAnimatablepublic class ContentElement : System.Windows.DependencyObject, System.Windows.IInputElement, System.Windows.Media.Animation.IAnimatabletype ContentElement = class
inherit DependencyObject
interface IInputElement
interface IAnimatablePublic Class ContentElement
Inherits DependencyObject
Implements IAnimatable, IInputElement- 继承
- 派生
- 实现
注解
ContentElement 定义以下常见内容特征：
输入：所有 ContentElement 派生类都支持通过键盘、鼠标、拖放操作、触笔控件和快捷键捕获基本输入。
焦点：所有 ContentElement 派生类都可能具有焦点。 (但是，基类的默认可聚焦状态 ContentElement 为
false。有关如何使焦点可聚焦 ContentElement 的详细信息，请参阅 Focusable.) 此外，此类包含可用于跨相关元素遍历焦点的 API。事件： ContentElement 包括与输入和焦点相关的事件;它还包括状态更改的事件。 在许多情况下， ContentElement 事件是路由事件。 在某些情况下，路由事件同时具有隧道和浮升路由策略，这些策略作为单独的事件引发，以响应相同的状态或条件。 此外， ContentElement 还定义了可以引发路由事件的 API，并且可以向事件添加或删除处理程序。
ContentElement 与 UIElement共享许多通用 API。 这些常见 API 不来自共享类继承。 但是，它们在每个类中共享通用的命名、类似的行为和类似的 API 内部实现。 相似性是因为 ContentElement 和 UIElement 是作为元素基础的每个类，尽管每个类对其标记对象模型行为具有不同的意图。
具体而言，从 Visual提供较低级别的图形支持，UIElement以便将 呈现ContentElement到复合窗口中的矩形区域，而ContentElement延迟呈现，以便更轻松地支持文档方案（如流和包装）更常见的概念。 这两个相关的类还实现公共接口 IInputElement 和 IAnimatable。
继承者的注释
类 ContentElement 尚未定义流样式演示文稿的完整内容元素的所有方面。 FrameworkContentElement 是 的直接派生类 ContentElement。 FrameworkContentElement 包括一组更完整的附加成员，这些成员支持在内容主机中使用 WPF 框架级布局系统呈现 FrameworkContentElement 。
构造函数
| ContentElement() |
初始化 ContentElement 类的新实例。 |
字段
属性
| AllowDrop |
获取或设置一个值，该值指示此元素能否用作拖放操作的目标。 |
| AreAnyTouchesCaptured |
获取一个值，该值指示在此元素上是否至少捕获了一次触摸。 |
| AreAnyTouchesCapturedWithin |
获取一个值，该值指示在此元素或其可视化树中的任何子元素上是否至少捕获了一次触摸。 |
| AreAnyTouchesDirectlyOver |
获取一个值，该值指示在此元素上是否至少按下了一次触摸设备。 |
| AreAnyTouchesOver |
获取一个值，该值指示在此元素或其可视化树中的任何子元素上是否至少按下了一次触摸设备。 |
| CommandBindings |
获取与此元素关联的 CommandBinding 对象的集合。 |
| DependencyObjectType |
DependencyObjectType获取包装此实例的 CLR 类型的 。 (继承自 DependencyObject) |
| Dispatcher |
获取与此 Dispatcher 关联的 DispatcherObject。 (继承自 DispatcherObject) |
| Focusable |
获取或设置一个值，该值指示元素能否得到焦点。 |
| HasAnimatedProperties |
获取一个值，该值指示此元素是否具有任何进行动画处理的属性。 |
| InputBindings |
获取与此元素关联的输入绑定的集合。 |
| IsEnabled |
获取或设置一个值，该值指示是否在用户界面 (UI) 中启用此元素。 |
| IsEnabledCore |
获取一个值，该值成为派生类中 IsEnabled 的返回值。 |
| IsFocused |
获取一个值，该值确定此元素是否具有逻辑焦点。 |
| IsInputMethodEnabled |
获取一个值，该值指示是否启用输入法系统（例如输入法编辑器 (IME) ）来处理此元素的输入。 |
| IsKeyboardFocused |
获取一个值，该值表示此元素是否具有键盘焦点。 |
| IsKeyboardFocusWithin |
获取一个值，该值指示键盘焦点是否位于元素或子元素内的任意位置。 |
| IsMouseCaptured |
获取一个值，该值指示此元素是否捕获了鼠标。 |
| IsMouseCaptureWithin |
获取一个值，该值确定此元素或其元素树中的子元素是否有鼠标捕获。 |
| IsMouseDirectlyOver |
获取一个值，该值指示在考虑元素组合的情况下，鼠标指针的位置是否与命中测试结果相对应。 |
| IsMouseOver |
获取一个值，该值指示鼠标指针是否位于此元素（包括可视子元素或其控件组合）上。 |
| IsSealed |
获取一个值，该值指示此实例当前是否为密封的（只读）。 (继承自 DependencyObject) |
| IsStylusCaptured |
获取一个值，该值指示是否将触笔捕获到此元素。 |
| IsStylusCaptureWithin |
获取一个值，该值确定此元素（包括子元素和控件组合）是否具有触笔捕获。 |
| IsStylusDirectlyOver |
获取一个值，该值指示在考虑元素组合的情况下，触笔的位置是否与命中测试结果相对应。 |
| IsStylusOver |
获取一个值，该值指示触笔是否位于此元素（包括可视子元素）上。 |
| TouchesCaptured |
获取在此元素上捕获的所有触摸设备。 |
| TouchesCapturedWithin |
获取在此元素或其可视化树中的任何子元素上捕获的所有触摸设备。 |
| TouchesDirectlyOver |
获取此元素上的所有触摸设备。 |
| TouchesOver |
获取在此元素或其可视化树中的任何子元素上的所有触摸设备。 |
方法
事件
| DragEnter |
在输入系统报告出现以此元素为拖动目标的基础拖动事件时发生。 |
| DragLeave |
在输入系统报告出现以此元素为拖动起点的基础拖动事件时发生。 |
| DragOver |
在输入系统报告出现以此元素为可能放置目标的基础拖动事件时发生。 |
| Drop |
在输入系统报告出现将此元素作为放置目标的基础放置事件时发生。 |
| FocusableChanged |
当 Focusable 属性的值更改时发生。 |
| GiveFeedback |
在输入系统报告出现涉及此元素的基础拖放操作时发生。 |
| GotFocus |
在此元素获得逻辑焦点时发生。 |
| GotKeyboardFocus |
在此元素聚焦于键盘时发生。 |
| GotMouseCapture |
在此元素捕获鼠标时发生。 |
| GotStylusCapture |
在此元素捕获触笔时发生。 |
| GotTouchCapture |
在此元素上捕获触摸屏输入时发生。 |
| IsEnabledChanged |
在此元素的 IsEnabled 属性值更改时发生。 |
| IsKeyboardFocusedChanged |
在此元素的 IsKeyboardFocused 属性值更改时发生。 |
| IsKeyboardFocusWithinChanged |
在此元素的 IsKeyboardFocusWithinChanged 属性值更改时发生。 |
| IsMouseCapturedChanged |
在此元素的 IsMouseCaptured 属性值更改时发生。 |
| IsMouseCaptureWithinChanged |
在此元素的 IsMouseCaptureWithinProperty 值更改时发生。 |
| IsMouseDirectlyOverChanged |
在此元素的 IsMouseDirectlyOver 属性值更改时发生。 |
| IsStylusCapturedChanged |
在此元素的 IsStylusCaptured 属性值更改时发生。 |
| IsStylusCaptureWithinChanged |
在此元素的 IsStylusCaptureWithin 属性值更改时发生。 |
| IsStylusDirectlyOverChanged |
在此元素的 IsStylusDirectlyOver 属性值更改时发生。 |
| KeyDown |
当焦点在该元素上时按下某个键后发生。 |
| KeyUp |
当焦点在该元素上时松开某个键后发生。 |
| LostFocus |
在此元素丢失逻辑焦点时发生。 |
| LostKeyboardFocus |
在此元素不再聚焦于键盘时发生。 |
| LostMouseCapture |
在此元素丢失鼠标捕获时发生。 |
| LostStylusCapture |
在此元素丢失触笔捕获时发生。 |
| LostTouchCapture |
在此元素失去触摸屏输入捕获时发生。 |
| MouseDown |
在指针位于此元素上并且按下任意鼠标按钮时发生。 |
| MouseEnter |
在鼠标指针进入此元素的边界时发生。 |
| MouseLeave |
在鼠标指针离开此元素的边界时发生。 |
| MouseLeftButtonDown |
在鼠标指针位于此元素上并且按下鼠标左键时发生。 |
| MouseLeftButtonUp |
在鼠标指针位于此元素上并且松开鼠标左键时发生。 |
| MouseMove |
在鼠标指针位于此元素上并且移动鼠标指针时发生。 |
| MouseRightButtonDown |
在鼠标指针位于此元素上并且按下鼠标右键时发生。 |
| MouseRightButtonUp |
在鼠标指针位于此元素上并且松开鼠标右键时发生。 |
| MouseUp |
在鼠标指针位于此元素上并且松开任意鼠标按钮时发生。 |
| MouseWheel |
在鼠标指针位于此元素上并且用户滚动鼠标滚轮时发生。 |
| PreviewDragEnter |
在输入系统报告出现以此元素为拖动目标的基础拖动事件时发生。 |
| PreviewDragLeave |
在输入系统报告出现以此元素为拖动起点的基础拖动事件时发生。 |
| PreviewDragOver |
在输入系统报告出现以此元素为可能放置目标的基础拖动事件时发生。 |
| PreviewDrop |
在输入系统报告出现将此元素作为放置目标的基础放置事件时发生。 |
| PreviewGiveFeedback |
在开始拖放操作时发生。 |
| PreviewGotKeyboardFocus |
在此元素聚焦于键盘时发生。 |
| PreviewKeyDown |
在此元素聚焦于键盘并且按下某个键时发生。 |
| PreviewKeyUp |
在此元素聚焦于键盘并且松开某个键时发生。 |
| PreviewLostKeyboardFocus |
在此元素不再聚焦于键盘时发生。 |
| PreviewMouseDown |
在指针位于此元素上并且按下任意鼠标按钮时发生。 |
| PreviewMouseLeftButtonDown |
在鼠标指针位于此元素上并且按下鼠标左键时发生。 |
| PreviewMouseLeftButtonUp |
在鼠标指针位于此元素上并且松开鼠标左键时发生。 |
| PreviewMouseMove |
在鼠标指针位于此元素上并且移动鼠标指针时发生。 |
| PreviewMouseRightButtonDown |
在鼠标指针位于此元素上并且按下鼠标右键时发生。 |
| PreviewMouseRightButtonUp |
在鼠标指针位于此元素上并且松开鼠标右键时发生。 |
| PreviewMouseUp |
在鼠标指针位于此元素上并且松开任意鼠标按钮时发生。 |
| PreviewMouseWheel |
在鼠标指针位于此元素上并且用户滚动鼠标滚轮时发生。 |
| PreviewQueryContinueDrag |
在拖放操作期间键盘或鼠标按钮的状态改变时发生。 |
| PreviewStylusButtonDown |
在指针位于此元素上并且按下触笔按钮时发生。 |
| PreviewStylusButtonUp |
在指针位于此元素上并且松开触笔按钮时发生。 |
| PreviewStylusDown |
当触笔位于元素上且触及数字化器时发生。 |
| PreviewStylusInAirMove |
在触笔掠过元素但并未实际接触数字化器时发生。 |
| PreviewStylusInRange |
在触笔位于此元素上并且触笔与数字化器之间的距离近到足以检测到触笔时发生。 |
| PreviewStylusMove |
在触笔位于元素上并且移动触笔时发生。 数字化器在检测触笔时，触笔必须处于移动状态才会引发此事件，否则将改为引发 PreviewStylusInAirMove。 |
| PreviewStylusOutOfRange |
在触笔与数字化仪之间的距离太远以致无法检测到触笔时发生。 |
| PreviewStylusSystemGesture |
在用户采用某一种触笔笔势时发生。 |
| PreviewStylusUp |
当触笔位于此元素上并且用户将触笔抬离数字化器时发生。 |
| PreviewTextInput |
在此元素以设备无关模式获取文本时发生。 |
| PreviewTouchDown |
当悬停在此元素上方的手指触摸屏幕时发生。 |
| PreviewTouchMove |
当悬停在此元素上方的手指在屏幕上移动时发生。 |
| PreviewTouchUp |
当悬停在此元素上方的手指从屏幕上移开时发生。 |
| QueryContinueDrag |
在拖放操作期间键盘或鼠标按钮的状态改变时发生。 |
| QueryCursor |
当请求显示光标时发生。 每次鼠标指针移至新位置时都会在一个元素上引发此事件，这意味着光标对象可能需要根据其新位置进行更改。 |
| StylusButtonDown |
在指针位于此元素上并且按下触笔按钮时发生。 |
| StylusButtonUp |
在指针位于此元素上并且松开触笔按钮时发生。 |
| StylusDown |
在触笔位于此元素上且同时触及数字化器时发生。 |
| StylusEnter |
在触笔进入此元素的边界时发生。 |
| StylusInAirMove |
在触笔掠过元素但并未实际接触数字化器时发生。 |
| StylusInRange |
在触笔位于此元素上并且触笔与数字化器之间的距离近到足以检测到触笔时发生。 |
| StylusLeave |
在触笔离开元素的边界时发生。 |
| StylusMove |
在触笔移到此元素上时发生。 触笔必须在位于数字化器上时移动，才会引发此事件。 否则将改为引发 StylusInAirMove。 |
| StylusOutOfRange |
在触笔位于此元素上并且触笔与数字化器之间的距离太远以致无法检测到触笔时发生。 |
| StylusSystemGesture |
在用户采用某一种触笔笔势时发生。 |
| StylusUp |
当触笔位于此元素上并且用户将触笔抬离数字化器时发生。 |
| TextInput |
在此元素以设备无关模式获取文本时发生。 |
| TouchDown |
当悬停在此元素上方的手指触摸屏幕时发生。 |
| TouchEnter |
在触摸屏输入从此元素边界外部移动到其内部时发生。 |
| TouchLeave |
在触摸屏输入从此元素边界内部移动到其外部时发生。 |
| TouchMove |
当悬停在此元素上方的手指在屏幕上移动时发生。 |
| TouchUp |
当悬停在此元素上方的手指从屏幕上移开时发生。 |
