RichTextBox 类
定义
重要
一些信息与预发行产品相关，相应产品在发行之前可能会进行重大修改。 对于此处提供的信息，Microsoft 不作任何明示或暗示的担保。
表示对 FlowDocument 对象进行操作的丰富编辑控件。
public ref class RichTextBox : System::Windows::Controls::Primitives::TextBoxBase, System::Windows::Markup::IAddChild[System.Windows.Localizability(System.Windows.LocalizationCategory.Inherit)]
[System.Windows.Markup.ContentProperty("Document")]
public class RichTextBox : System.Windows.Controls.Primitives.TextBoxBase, System.Windows.Markup.IAddChild[<System.Windows.Localizability(System.Windows.LocalizationCategory.Inherit)>]
[<System.Windows.Markup.ContentProperty("Document")>]
type RichTextBox = class
inherit TextBoxBase
interface IAddChildPublic Class RichTextBox
Inherits TextBoxBase
Implements IAddChild- 继承
- 属性
- 实现
示例
以下示例声明一个 RichTextBox 包含简单 FlowDocument的 。
<RichTextBox Name="richTB">
<FlowDocument>
<Paragraph>
<Run>Paragraph 1</Run>
</Paragraph>
<Paragraph>
<Run>Paragraph 2</Run>
</Paragraph>
<Paragraph>
<Run>Paragraph 3</Run>
</Paragraph>
</FlowDocument>
</RichTextBox>
using System;
using System.Windows;
using System.Windows.Controls;
using System.Windows.Media;
using System.Windows.Documents;
namespace SDKSample
{
public partial class RichTextBoxExample : Page
{
public RichTextBoxExample()
{
StackPanel myStackPanel = new StackPanel();
// Create a FlowDocument to contain content for the RichTextBox.
FlowDocument myFlowDoc = new FlowDocument();
// Add paragraphs to the FlowDocument.
myFlowDoc.Blocks.Add(new Paragraph(new Run("Paragraph 1")));
myFlowDoc.Blocks.Add(new Paragraph(new Run("Paragraph 2")));
myFlowDoc.Blocks.Add(new Paragraph(new Run("Paragraph 3")));
RichTextBox myRichTextBox = new RichTextBox();
// Add initial content to the RichTextBox.
myRichTextBox.Document = myFlowDoc;
myStackPanel.Children.Add(myRichTextBox);
this.Content = myStackPanel;
}
}
}
Imports System.Windows
Imports System.Windows.Controls
Imports System.Windows.Media
Imports System.Windows.Documents
Namespace SDKSample
Partial Public Class RichTextBoxExample
Inherits Page
Public Sub New()
Dim myStackPanel As New StackPanel()
' Create a FlowDocument to contain content for the RichTextBox.
Dim myFlowDoc As New FlowDocument()
' Add paragraphs to the FlowDocument.
myFlowDoc.Blocks.Add(New Paragraph(New Run("Paragraph 1")))
myFlowDoc.Blocks.Add(New Paragraph(New Run("Paragraph 2")))
myFlowDoc.Blocks.Add(New Paragraph(New Run("Paragraph 3")))
Dim myRichTextBox As New RichTextBox()
' Add initial content to the RichTextBox.
myRichTextBox.Document = myFlowDoc
myStackPanel.Children.Add(myRichTextBox)
Me.Content = myStackPanel
End Sub
End Class
End Namespace
注解
FlowDocument 是 支持的唯一 RichTextBox子元素。
重要
RichTextBox 具有针对浮泡 MouseUp 和 MouseDown 事件的内置处理。 因此，从 中侦听 MouseUp 或 MouseDown 事件的 RichTextBox 自定义事件处理程序永远不会被调用。 如果需要响应这些事件，请改为侦听隧道 PreviewMouseUp 和 PreviewMouseDown 事件，或使用 参数注册处理程序 HandledEventsToo (后一个选项只能通过代码) 。 除非有意禁用 RichTextBox 这些事件的本机处理，否则不要将事件标记为已处理，并且请注意，这会对控件的 UI 产生显著影响。
虽然 RichTextBox 支持复制和粘贴图像，但某些方案目前不受支持，可能无法正常工作。 下表汇总了这些方案和预期结果。
| 图像复制源 | 图像粘贴结果 |
|---|---|
| 图像源是图形图元文件 | 不粘贴图像 |
| 图像源使用相对路径或链接 | 粘贴了乱码或空白图像 |
| 图像源链接未以预期的图像格式 (.PNG、.JPG、.GIF) 结束 | 粘贴了乱码或空白图像 |
| 从格式不正确的 RichText (RTF) 复制的图像源 | 图像源的链接粘贴 (而不是图像) |
将 HTML 内容粘贴到 可能会导致意外行为， RichTextBox 因为 RichTextBox 使用 RTF 格式而不是直接使用 HTML 格式。
文本始终在 中 RichTextBox换行。 如果不希望文本换行， PageWidth 请将 上的 FlowDocument 设置为大于 的 RichTextBox宽度。 但是，一旦达到页面宽度，文本仍会换行。
在 中 RichTextBox 水平和垂直对齐的内容是使用 HorizontalContentAlignment 和 VerticalContentAlignment 属性完成的。 RichTextBox使用 和 VerticalAlignment 属性在页面布局内对齐 HorizontalAlignment 。
默认情况下，滚动条在 上 RichTextBox 不可见。 若要使滚动条可见，请将 VerticalScrollBarVisibility 属性设置为 Visible 或 Auto。
通常，TextChanged事件应用于检测 或 RichTextBox 中的TextBox文本何时发生更改，而不是KeyDown如你所料的那样。 有关示例，请参阅 如何：检测 TextBox 中的文本更改时间。
RichTextBox 支持各种键盘命令。 有关键盘命令的列表，请参阅 EditingCommands。
此控件的依赖属性可能由控件的默认样式设置。 如果属性由默认样式设置，则当控件出现在应用程序中时，该属性可能会从其默认值更改。 默认样式由应用程序运行时使用的桌面主题决定。
构造函数
| RichTextBox() |
初始化 RichTextBox 类的新的默认实例。 |
| RichTextBox(FlowDocument) |
初始化 RichTextBox 类的一个新实例，以将指定的 FlowDocument 作为初始内容添加。 |
字段
| IsDocumentEnabledProperty |
标识 IsDocumentEnabled 依赖项属性。 |
属性
| AcceptsReturn |
获取或设置一个值，该值指示在用户按 ENTER 键时文本编辑控件如何响应。 (继承自 TextBoxBase) |
| AcceptsTab |
获取或设置一个值，该值指示在用户按 TAB 键时文本编辑控件如何响应。 (继承自 TextBoxBase) |
| ActualHeight |
获取此元素的呈现高度。 (继承自 FrameworkElement) |
| ActualWidth |
获取此元素的呈现宽度。 (继承自 FrameworkElement) |
| AllowDrop |
获取或设置一个值，该值指示此元素能否用作拖放操作的目标。 这是依赖项属性。 (继承自 UIElement) |
| AreAnyTouchesCaptured |
获取一个值，该值指示在此元素上是否至少捕获了一次触摸。 (继承自 UIElement) |
| AreAnyTouchesCapturedWithin |
获取一个值，该值指示在此元素或其可视化树中的任何子元素上是否至少捕获了一次触摸。 (继承自 UIElement) |
| AreAnyTouchesDirectlyOver |
获取一个值，该值指示在此元素上是否至少按下了一次触摸设备。 (继承自 UIElement) |
| AreAnyTouchesOver |
获取一个值，该值指示在此元素或其可视化树中的任何子元素上是否至少按下了一次触摸设备。 (继承自 UIElement) |
| AutoWordSelection |
获取或设置一个值，该值决定在用户通过在单词中拖动鼠标来选择单词的一部分时是否同时选定该单词的其余部分。 (继承自 TextBoxBase) |
| Background |
获取或设置一个用于描述控件背景的画笔。 (继承自 Control) |
| BindingGroup |
获取或设置用于该元素的 BindingGroup。 (继承自 FrameworkElement) |
| BitmapEffect |
已过时.
已过时.
获取或设置一个位图效果，该效果将直接应用到此元素所呈现的内容。 这是依赖项属性。 (继承自 UIElement) |
| BitmapEffectInput |
已过时.
已过时.
获取或设置位图效果的输入源，该效果将直接应用到此元素所呈现的内容。 这是依赖项属性。 (继承自 UIElement) |
| BorderBrush |
获取或设置一个用于描述控件的边框背景的画笔。 (继承自 Control) |
| BorderThickness |
获取或设置控件的边框宽度。 (继承自 Control) |
| CacheMode |
获取或设置 UIElement 的缓存表示形式。 (继承自 UIElement) |
| CanRedo |
获取一个值，该值指示是否可重做最新的撤消操作。 (继承自 TextBoxBase) |
| CanUndo |
获取一个值，该值指示是否可撤消最新的操作。 (继承自 TextBoxBase) |
| CaretBrush |
获取或设置用于绘制文本框的插入符号的画笔。 (继承自 TextBoxBase) |
| CaretPosition |
获取或设置输入插入符号的位置。 |
| Clip |
获取或设置用于定义元素内容轮廓的几何图形。 这是依赖项属性。 (继承自 UIElement) |
| ClipToBounds |
获取或设置一个值，该值指示是否剪切此元素的内容(或来自此元素的子元素的内容)使其适合包含元素的大小。 这是依赖项属性。 (继承自 UIElement) |
| CommandBindings |
获取与此元素关联的 CommandBinding 对象的集合。 CommandBinding 为此元素启用命令处理，并声明命令、命令的事件和由此元素附加的处理程序之间的链接。 (继承自 UIElement) |
| ContextMenu |
获取或设置上下文菜单元素，每当通过用户界面 (UI 从此元素内) 请求上下文菜单时，应显示该元素。 (继承自 FrameworkElement) |
| Cursor |
获取或设置在鼠标指针位于此元素上时显示的光标。 (继承自 FrameworkElement) |
| DataContext |
获取或设置元素参与数据绑定时的数据上下文。 (继承自 FrameworkElement) |
| DefaultStyleKey |
获取或设置在使用或定义主题样式时要用于引用此控件样式的键。 (继承自 FrameworkElement) |
| DependencyObjectType |
DependencyObjectType获取包装此实例的 CLR 类型的 。 (继承自 DependencyObject) |
| DesiredSize |
获取在布局流程的度量传递过程中此元素计算所得的大小。 (继承自 UIElement) |
| Dispatcher |
获取与此 Dispatcher 关联的 DispatcherObject。 (继承自 DispatcherObject) |
| Document |
获取或设置表示 FlowDocument 的内容的 RichTextBox。 |
| Effect |
获取或设置要应用于 UIElement 的位图效果。 这是依赖项属性。 (继承自 UIElement) |
| ExtentHeight |
获取可见内容区域的垂直大小。 (继承自 TextBoxBase) |
| ExtentWidth |
获取可见内容区域的水平大小。 (继承自 TextBoxBase) |
| FlowDirection |
获取或设置文本和其他用户界面 (UI) 元素在控制其布局的任何父元素内流动的方向。 (继承自 FrameworkElement) |
| Focusable |
获取或设置一个值，该值指示元素能否得到焦点。 这是依赖项属性。 (继承自 UIElement) |
| FocusVisualStyle |
获取或设置一个属性，该属性允许自定义此元素在捕获到键盘焦点时要应用于此元素的外观、效果或其他样式特征。 (继承自 FrameworkElement) |
| FontFamily |
获取或设置控件的字体系列。 (继承自 Control) |
| FontSize |
获取或设置字号。 (继承自 Control) |
| FontStretch |
获取或设置字体在屏幕上紧缩或加宽的程度。 (继承自 Control) |
| FontStyle |
获取或设置字体样式。 (继承自 Control) |
| FontWeight |
获取或设置指定字体的粗细。 (继承自 Control) |
| ForceCursor |
获取或设置一个值，该值指示这是否 FrameworkElement 应强制用户界面 (UI) 呈现由 属性声明的 Cursor 光标。 (继承自 FrameworkElement) |
| Foreground |
获取或设置一个用于描述前景色的画笔。 (继承自 Control) |
| HandlesScrolling |
获取一个值，该值指示控件是否支持滚动。 (继承自 Control) |
| HasAnimatedProperties |
获取一个值，该值指示此元素是否具有任何进行动画处理的属性。 (继承自 UIElement) |
| HasEffectiveKeyboardFocus |
获取一个值，该值指示 UIElement 是否具有焦点。 (继承自 UIElement) |
| Height |
获取或设置元素的建议高度。 (继承自 FrameworkElement) |
| HorizontalAlignment |
获取或设置在父元素(如 Panel 或项控件)中组合此元素时所应用的水平对齐特征。 (继承自 FrameworkElement) |
| HorizontalContentAlignment |
获取或设置控件内容的水平对齐方式。 (继承自 Control) |
| HorizontalOffset |
获取或设置水平滚动条位置。 (继承自 TextBoxBase) |
| HorizontalScrollBarVisibility |
获取或设置一个值，该值指示是否显示水平滚动条。 (继承自 TextBoxBase) |
| InheritanceBehavior |
获取或设置属性值继承、资源键查找和RelativeSource FindAncestor 查找的范围限制。 (继承自 FrameworkElement) |
| InputBindings |
获取与此元素关联的输入绑定的集合。 (继承自 UIElement) |
| InputScope |
获取或设置此 FrameworkElement 使用的输入的上下文。 (继承自 FrameworkElement) |
| IsArrangeValid |
获取一个值，该值指示此元素布局中的子元素的计算大小和位置是否有效。 (继承自 UIElement) |
| IsDocumentEnabled |
获取或设置一个值，该值指示用户是否可以与 UIElement 内的 ContentElement 和 RichTextBox 对象进行交互。 |
| IsEnabled |
获取或设置一个值，该值指示是否在用户界面 (UI) 中启用此元素。 这是依赖项属性。 (继承自 UIElement) |
| IsEnabledCore |
获取一个值，该值成为派生类中 IsEnabled 的返回值。 (继承自 UIElement) |
| IsFocused |
获取一个值，该值确定此元素是否具有逻辑焦点。 这是依赖项属性。 (继承自 UIElement) |
| IsHitTestVisible |
获取或设置一个值，该值声明是否可以返回此元素作为其呈现内容的某些部分的点击测试结果。 这是依赖项属性。 (继承自 UIElement) |
| IsInactiveSelectionHighlightEnabled |
获取或设置指示当文本框没有焦点时，文本框是否显示所选文本的值。 (继承自 TextBoxBase) |
| IsInitialized |
获取一个值，该值指示此元素是在 XAML 处理器处理期间初始化的，还是显式调用其 EndInit() 方法。 (继承自 FrameworkElement) |
| IsInputMethodEnabled |
获取一个值，该值指示是否启用输入法系统（例如输入法编辑器 (输入法) ）来处理此元素的输入。 (继承自 UIElement) |
| IsKeyboardFocused |
获取一个值，该值表示该元素是否具有键盘焦点。 这是依赖项属性。 (继承自 UIElement) |
| IsKeyboardFocusWithin |
获取一个值，该值指示键盘焦点是否位于元素或其可视化树子元素内的任意位置。 这是依赖项属性。 (继承自 UIElement) |
| IsLoaded |
获取一个值，该值指示是否已加载此元素以供呈现。 (继承自 FrameworkElement) |
| IsManipulationEnabled |
获取或设置一个值，该值指示是否对此 UIElement 启用操作事件。 (继承自 UIElement) |
| IsMeasureValid |
获取一个值，该值指示布局测量返回的当前大小是否有效。 (继承自 UIElement) |
| IsMouseCaptured |
获取一个值，该值指示此元素是否捕获了鼠标。 这是依赖项属性。 (继承自 UIElement) |
| IsMouseCaptureWithin |
获取一个值，该值确定鼠标捕获是由此元素还是其可视化树中的子元素持有。 这是依赖项属性。 (继承自 UIElement) |
| IsMouseDirectlyOver |
获取一个值，该值指示在考虑元素组合的情况下，鼠标指针的位置是否与命中测试结果相对应。 这是依赖项属性。 (继承自 UIElement) |
| IsMouseOver |
获取一个值，该值指示鼠标指针是否位于此元素（包括可视化树中的子元素）的上方。 这是依赖项属性。 (继承自 UIElement) |
| IsReadOnly |
获取或设置一个值，该值指示文本编辑控件对于与该控件交互的用户是否是只读的。 (继承自 TextBoxBase) |
| IsReadOnlyCaretVisible |
获取或设置一个值，该值指示只读文本框是否显示插入符号。 (继承自 TextBoxBase) |
| IsSealed |
获取一个值，该值指示此实例当前是否为密封的（只读）。 (继承自 DependencyObject) |
| IsSelectionActive |
获取指示文本框是否具有焦点和选择文本的值。 (继承自 TextBoxBase) |
| IsStylusCaptured |
获取一个值，该值表示此元素是否捕获了触笔。 这是依赖项属性。 (继承自 UIElement) |
| IsStylusCaptureWithin |
获取一个值，该值确定触笔捕获是由此元素还是由元素边界内的元素及其可视化树持有。 这是依赖项属性。 (继承自 UIElement) |
| IsStylusDirectlyOver |
获取一个值，该值指示在考虑元素组合的情况下，触笔的位置是否与命中测试结果相对应。 这是依赖项属性。 (继承自 UIElement) |
| IsStylusOver |
获取一个值，该值指示触笔指针是否位于此元素（包括可视化子元素）的上方。 这是依赖项属性。 (继承自 UIElement) |
| IsTabStop |
获取或设置一个值，该值指示是否将某个控件包含在 Tab 导航中。 (继承自 Control) |
| IsUndoEnabled |
获取或设置一个值，该值指示文本编辑控件是否支持撤消功能。 (继承自 TextBoxBase) |
| IsVisible |
获取一个值，该值指示此元素在用户界面 (UI) 中是否可见。 这是依赖项属性。 (继承自 UIElement) |
| Language |
获取或设置应用于某个元素的本地化/全球化语言信息。 (继承自 FrameworkElement) |
| LayoutTransform |
获取或设置在执行布局时应用于此元素的图形转换。 (继承自 FrameworkElement) |
| LogicalChildren |
获取一个可循环访问 |
| Margin |
获取或设置元素的外边距。 (继承自 FrameworkElement) |
| MaxHeight |
获取或设置元素的最大高度约束。 (继承自 FrameworkElement) |
| MaxWidth |
获取或设置元素的最大宽度约束。 (继承自 FrameworkElement) |
| MinHeight |
获取或设置元素的最小高度约束。 (继承自 FrameworkElement) |
| MinWidth |
获取或设置元素的最小宽度约束。 (继承自 FrameworkElement) |
| Name |
获取或设置元素的标识名称。 该名称提供引用，以便代码隐藏（如事件处理程序代码）可以在 XAML 处理器处理期间构造标记元素后引用它。 (继承自 FrameworkElement) |
| Opacity |
获取或设置在用户界面 (UI) 呈现时应用于整个 UIElement 的不透明度因子。 这是依赖项属性。 (继承自 UIElement) |
| OpacityMask |
获取或设置一个作为 Brush 实现的不透明蒙板，该蒙板可应用到此元素所呈现内容的任何 Alpha 通道蒙板。 这是依赖项属性。 (继承自 UIElement) |
| OverridesDefaultStyle |
获取或设置一个值，该值指示此元素是否并入主题样式中的样式属性。 (继承自 FrameworkElement) |
| Padding |
获取或设置控件内部的填充边距。 (继承自 Control) |
| Parent |
获取此元素的逻辑父元素。 (继承自 FrameworkElement) |
| PersistId |
已过时.
获取一个唯一标识此元素的值。 (继承自 UIElement) |
| RenderSize |
获取（或设置）此元素的最终呈现大小。 (继承自 UIElement) |
| RenderTransform |
获取或设置影响此元素的呈现位置的转换信息。 这是依赖项属性。 (继承自 UIElement) |
| RenderTransformOrigin |
获取或设置由 RenderTransform 声明的任何可能呈现转换的中心点，相对于元素的边界。 这是依赖项属性。 (继承自 UIElement) |
| Resources |
获取或设置本地定义的资源字典。 (继承自 FrameworkElement) |
| Selection |
获取一个包含 RichTextBox 中当前选定内容的 TextSelection 对象。 |
| SelectionBrush |
获取或设置会突出显示选定文本的画笔。 (继承自 TextBoxBase) |
| SelectionOpacity |
获取或设置 SelectionBrush 的不透明度。 (继承自 TextBoxBase) |
| SelectionTextBrush |
获取或设置一个值，此值定义用于所选文本的画笔。 (继承自 TextBoxBase) |
| SnapsToDevicePixels |
获取或设置一个值，该值确定在呈现过程中，此元素的呈现是否应使用特定于设备的像素设置。 这是依赖项属性。 (继承自 UIElement) |
| SpellCheck |
获取一个 SpellCheck 对象，通过它可以访问 TextBoxBase 或 RichTextBox 文本内容中的拼写错误。 (继承自 TextBoxBase) |
| Style |
获取或设置此元素呈现时所使用的样式。 (继承自 FrameworkElement) |
| StylusPlugIns |
获取与此元素关联的所有触笔插件（自定义）对象的集合。 (继承自 UIElement) |
| TabIndex |
获取或设置一个值，该值决定在用户使用 Tab 键在控件中导航时元素接收焦点的顺序。 (继承自 Control) |
| Tag |
获取或设置任意对象值，该值可用于存储关于此元素的自定义信息。 (继承自 FrameworkElement) |
| Template |
获取或设置控件模板。 (继承自 Control) |
| TemplatedParent |
获取对此元素的模板父级的引用。 如果该元素不是通过模板创建的，则此属性无关。 (继承自 FrameworkElement) |
| ToolTip |
获取或设置用户界面 (UI) 中为此元素显示的工具提示对象。 (继承自 FrameworkElement) |
| TouchesCaptured |
获取在此元素上捕获的所有触摸设备。 (继承自 UIElement) |
| TouchesCapturedWithin |
获取在此元素或其可视化树中的任何子元素上捕获的所有触摸设备。 (继承自 UIElement) |
| TouchesDirectlyOver |
获取此元素上的所有触摸设备。 (继承自 UIElement) |
| TouchesOver |
获取在此元素或其可视化树中的任何子元素上的所有触摸设备。 (继承自 UIElement) |
| Triggers |
获取直接在此元素上或在子元素中建立的触发器的集合。 (继承自 FrameworkElement) |
| Uid |
获取或设置此元素的唯一标识符（用于本地化）。 这是依赖项属性。 (继承自 UIElement) |
| UndoLimit |
获取或设置存储在撤消队列中的操作的数目。 (继承自 TextBoxBase) |
| UseLayoutRounding |
获取或设置一个值，该值指示是否应向此元素的大小和位置布局应用布局舍入。 (继承自 FrameworkElement) |
| VerticalAlignment |
获取或设置在父元素（如面板或项控件）中组合此元素时所应用的垂直对齐特征。 (继承自 FrameworkElement) |
| VerticalContentAlignment |
获取或设置控件内容的垂直对齐方式。 (继承自 Control) |
| VerticalOffset |
获取或设置垂直滚动条的位置。 (继承自 TextBoxBase) |
| VerticalScrollBarVisibility |
获取或设置一个值，该值指示是否显示垂直滚动条。 (继承自 TextBoxBase) |
| ViewportHeight |
获取可滚动的内容区域的垂直大小。 (继承自 TextBoxBase) |
| ViewportWidth |
获取可滚动的内容区域的水平大小。 (继承自 TextBoxBase) |
| Visibility |
获取或设置用户界面 (UI) 此元素的可见性。 这是依赖项属性。 (继承自 UIElement) |
| VisualBitmapEffect |
已过时.
已过时.
获取或设置 BitmapEffect 的 Visual 值。 (继承自 Visual) |
| VisualBitmapEffectInput |
已过时.
已过时.
获取或设置 BitmapEffectInput 的 Visual 值。 (继承自 Visual) |
| VisualBitmapScalingMode |
获取或设置 BitmapScalingMode 的 Visual。 (继承自 Visual) |
| VisualCacheMode |
获取或设置 Visual 的缓存表示形式。 (继承自 Visual) |
| VisualChildrenCount |
获取此元素内可视子元素的数目。 (继承自 FrameworkElement) |
| VisualClearTypeHint |
获取或设置 ClearTypeHint，它确定在 Visual 中呈现 ClearType 的方式。 (继承自 Visual) |
| VisualClip |
获取或设置 Visual 的剪辑区域作为 Geometry 值。 (继承自 Visual) |
| VisualEdgeMode |
获取或设置 Visual 的边缘模式作为 EdgeMode 值。 (继承自 Visual) |
| VisualEffect |
获取或设置要应用于 Visual 的位图效果。 (继承自 Visual) |
| VisualOffset |
获取或设置可视对象的偏移量值。 (继承自 Visual) |
| VisualOpacity |
获取或设置 Visual 的不透明度。 (继承自 Visual) |
| VisualOpacityMask |
获取或设置 Brush 值，该值表示 Visual 的不透明蒙板。 (继承自 Visual) |
| VisualParent |
获取可视对象的可视化树父级。 (继承自 Visual) |
| VisualScrollableAreaClip |
获取或设置 Visual 的剪辑的可滚动区域。 (继承自 Visual) |
| VisualTextHintingMode |
获取或设置 Visual 的 TextHintingMode。 (继承自 Visual) |
| VisualTextRenderingMode |
获取或设置 Visual 的 TextRenderingMode。 (继承自 Visual) |
| VisualTransform | (继承自 Visual) |
| VisualXSnappingGuidelines |
获取或设置 x 坐标（垂直）准线集合。 (继承自 Visual) |
| VisualYSnappingGuidelines |
获取或设置 Y 坐标（水平）准线集合。 (继承自 Visual) |
| Width |
获取或设置元素的宽度。 (继承自 FrameworkElement) |
方法
事件
| ContextMenuClosing |
在元素上的任何上下文菜单关闭之前发生。 (继承自 FrameworkElement) |
| ContextMenuOpening |
在元素上的任何上下文菜单打开时发生。 (继承自 FrameworkElement) |
| DataContextChanged |
在此元素的数据上下文更改时发生。 (继承自 FrameworkElement) |
| DragEnter |
在输入系统报告出现以此元素为拖动目标的基础拖动事件时发生。 (继承自 UIElement) |
| DragLeave |
在输入系统报告出现以此元素为拖动起点的基础拖动事件时发生。 (继承自 UIElement) |
| DragOver |
在输入系统报告出现以此元素为可能放置目标的基础拖动事件时发生。 (继承自 UIElement) |
| Drop |
在输入系统报告出现将此元素作为放置目标的基础放置事件时发生。 (继承自 UIElement) |
| FocusableChanged |
当 Focusable 属性的值更改时发生。 (继承自 UIElement) |
| GiveFeedback |
在输入系统报告出现涉及此元素的基础拖放操作时发生。 (继承自 UIElement) |
| GotFocus |
在此元素获得逻辑焦点时发生。 (继承自 UIElement) |
| GotKeyboardFocus |
在此元素聚焦于键盘时发生。 (继承自 UIElement) |
| GotMouseCapture |
在此元素捕获鼠标时发生。 (继承自 UIElement) |
| GotStylusCapture |
在此元素捕获触笔时发生。 (继承自 UIElement) |
| GotTouchCapture |
在此元素上捕获触摸屏输入时发生。 (继承自 UIElement) |
| Initialized |
初始化此 FrameworkElement 时发生。 此事件与 IsInitialized 属性的值从 |
| IsEnabledChanged |
在此元素的 IsEnabled 属性值更改时发生。 (继承自 UIElement) |
| IsHitTestVisibleChanged |
在此元素的 IsHitTestVisible 依赖项属性值更改时发生。 (继承自 UIElement) |
| IsKeyboardFocusedChanged |
在此元素的 IsKeyboardFocused 属性值更改时发生。 (继承自 UIElement) |
| IsKeyboardFocusWithinChanged |
在此元素的 IsKeyboardFocusWithin 属性值更改时发生。 (继承自 UIElement) |
| IsMouseCapturedChanged |
在此元素的 IsMouseCaptured 属性值更改时发生。 (继承自 UIElement) |
| IsMouseCaptureWithinChanged |
在此元素的 IsMouseCaptureWithinProperty 值更改时发生。 (继承自 UIElement) |
| IsMouseDirectlyOverChanged |
在此元素的 IsMouseDirectlyOver 属性值更改时发生。 (继承自 UIElement) |
| IsStylusCapturedChanged |
在此元素的 IsStylusCaptured 属性值更改时发生。 (继承自 UIElement) |
| IsStylusCaptureWithinChanged |
在此元素的 IsStylusCaptureWithin 属性值更改时发生。 (继承自 UIElement) |
| IsStylusDirectlyOverChanged |
在此元素的 IsStylusDirectlyOver 属性值更改时发生。 (继承自 UIElement) |
| IsVisibleChanged |
在此元素的 IsVisible 属性值更改时发生。 (继承自 UIElement) |
| KeyDown |
当焦点在该元素上时按下某个键后发生。 (继承自 UIElement) |
| KeyUp |
当焦点在该元素上时松开某个键后发生。 (继承自 UIElement) |
| LayoutUpdated |
在与当前 Dispatcher 关联的各种可视元素的布局更改时发生。 (继承自 UIElement) |
| Loaded |
当对元素进行布局、呈现，且可将其用于交互时发生。 (继承自 FrameworkElement) |
| LostFocus |
在此元素丢失逻辑焦点时发生。 (继承自 UIElement) |
| LostKeyboardFocus |
在此元素不再聚焦于键盘时发生。 (继承自 UIElement) |
| LostMouseCapture |
在此元素丢失鼠标捕获时发生。 (继承自 UIElement) |
| LostStylusCapture |
在此元素丢失触笔捕获时发生。 (继承自 UIElement) |
| LostTouchCapture |
在此元素失去触摸屏输入捕获时发生。 (继承自 UIElement) |
| ManipulationBoundaryFeedback |
当操作遇到边界时发生。 (继承自 UIElement) |
| ManipulationCompleted |
对于 UIElement 对象的操作和延时完毕时发生。 (继承自 UIElement) |
| ManipulationDelta |
当输入设备在操作期间更改位置时发生。 (继承自 UIElement) |
| ManipulationInertiaStarting |
当输入设备在操作期间与 UIElement 对象失去联系且延时开始时发生。 (继承自 UIElement) |
| ManipulationStarted |
当输入设备对 UIElement 对象开始操作时发生。 (继承自 UIElement) |
| ManipulationStarting |
在首次创建操作处理器时发生。 (继承自 UIElement) |
| MouseDoubleClick |
在双击或多次单击鼠标按钮时发生。 (继承自 Control) |
| MouseDown |
在指针位于此元素上并且按下任意鼠标按钮时发生。 (继承自 UIElement) |
| MouseEnter |
在鼠标指针进入此元素的边界时发生。 (继承自 UIElement) |
| MouseLeave |
在鼠标指针离开此元素的边界时发生。 (继承自 UIElement) |
| MouseLeftButtonDown |
在鼠标指针位于此元素上并且按下鼠标左键时发生。 (继承自 UIElement) |
| MouseLeftButtonUp |
在鼠标指针位于此元素上并且松开鼠标左键时发生。 (继承自 UIElement) |
| MouseMove |
在鼠标指针位于此元素上并且移动鼠标指针时发生。 (继承自 UIElement) |
| MouseRightButtonDown |
在鼠标指针位于此元素上并且按下鼠标右键时发生。 (继承自 UIElement) |
| MouseRightButtonUp |
在鼠标指针位于此元素上并且松开鼠标右键时发生。 (继承自 UIElement) |
| MouseUp |
在鼠标指针位于此元素上并且松开任意鼠标按钮时发生。 (继承自 UIElement) |
| MouseWheel |
在鼠标指针位于此元素上并且用户滚动鼠标滚轮时发生。 (继承自 UIElement) |
| PreviewDragEnter |
在输入系统报告出现以此元素为拖动目标的基础拖动事件时发生。 (继承自 UIElement) |
| PreviewDragLeave |
在输入系统报告出现以此元素为拖动起点的基础拖动事件时发生。 (继承自 UIElement) |
| PreviewDragOver |
在输入系统报告出现以此元素为可能放置目标的基础拖动事件时发生。 (继承自 UIElement) |
| PreviewDrop |
在输入系统报告出现将此元素作为放置目标的基础放置事件时发生。 (继承自 UIElement) |
| PreviewGiveFeedback |
在开始拖放操作时发生。 (继承自 UIElement) |
| PreviewGotKeyboardFocus |
在此元素聚焦于键盘时发生。 (继承自 UIElement) |
| PreviewKeyDown |
当焦点在该元素上时按下某个键后发生。 (继承自 UIElement) |
| PreviewKeyUp |
当焦点在该元素上时松开某个键后发生。 (继承自 UIElement) |
| PreviewLostKeyboardFocus |
在此元素不再聚焦于键盘时发生。 (继承自 UIElement) |
| PreviewMouseDoubleClick |
在用户单击鼠标按钮两次或更多次时发生。 (继承自 Control) |
| PreviewMouseDown |
在指针位于此元素上并且按下任意鼠标按钮时发生。 (继承自 UIElement) |
| PreviewMouseLeftButtonDown |
在鼠标指针位于此元素上并且按下鼠标左键时发生。 (继承自 UIElement) |
| PreviewMouseLeftButtonUp |
在鼠标指针位于此元素上并且松开鼠标左键时发生。 (继承自 UIElement) |
| PreviewMouseMove |
在鼠标指针位于此元素上并且移动鼠标指针时发生。 (继承自 UIElement) |
| PreviewMouseRightButtonDown |
在鼠标指针位于此元素上并且按下鼠标右键时发生。 (继承自 UIElement) |
| PreviewMouseRightButtonUp |
在鼠标指针位于此元素上并且松开鼠标右键时发生。 (继承自 UIElement) |
| PreviewMouseUp |
在鼠标指针位于此元素上并且松开任意鼠标按钮时发生。 (继承自 UIElement) |
| PreviewMouseWheel |
在鼠标指针位于此元素上并且用户滚动鼠标滚轮时发生。 (继承自 UIElement) |
| PreviewQueryContinueDrag |
在拖放操作期间键盘或鼠标按钮的状态改变时发生。 (继承自 UIElement) |
| PreviewStylusButtonDown |
在指针位于此元素上并且按下触笔按钮时发生。 (继承自 UIElement) |
| PreviewStylusButtonUp |
在指针位于此元素上并且松开触笔按钮时发生。 (继承自 UIElement) |
| PreviewStylusDown |
当触笔位于元素上且触及数字化器时发生。 (继承自 UIElement) |
| PreviewStylusInAirMove |
在触笔掠过元素但并未实际接触数字化器时发生。 (继承自 UIElement) |
| PreviewStylusInRange |
在触笔位于此元素上并且触笔与数字化器之间的距离近到足以检测到触笔时发生。 (继承自 UIElement) |
| PreviewStylusMove |
在触笔位于元素上并且移动触笔时发生。 数字化器在检测触笔时，触笔必须处于移动状态才会引发此事件，否则将改为引发 PreviewStylusInAirMove。 (继承自 UIElement) |
| PreviewStylusOutOfRange |
在触笔与数字化仪之间的距离太远以致无法检测到触笔时发生。 (继承自 UIElement) |
| PreviewStylusSystemGesture |
在用户采用某一种触笔笔势时发生。 (继承自 UIElement) |
| PreviewStylusUp |
当触笔位于此元素上并且用户将触笔抬离数字化器时发生。 (继承自 UIElement) |
| PreviewTextInput |
在此元素以设备无关模式获取文本时发生。 (继承自 UIElement) |
| PreviewTouchDown |
当悬停在此元素上方的手指触摸屏幕时发生。 (继承自 UIElement) |
| PreviewTouchMove |
当悬停在此元素上方的手指在屏幕上移动时发生。 (继承自 UIElement) |
| PreviewTouchUp |
当悬停在此元素上方的手指从屏幕上移开时发生。 (继承自 UIElement) |
| QueryContinueDrag |
在拖放操作期间键盘或鼠标按钮的状态改变时发生。 (继承自 UIElement) |
| QueryCursor |
当请求显示光标时发生。 每次鼠标指针移至新位置时都会在一个元素上引发此事件，这意味着光标对象可能需要根据其新位置进行更改。 (继承自 UIElement) |
| RequestBringIntoView |
当在此元素上调用 BringIntoView(Rect) 时发生。 (继承自 FrameworkElement) |
| SelectionChanged |
在文本选择改变时发生。 (继承自 TextBoxBase) |
| SizeChanged |
当此元素上的 ActualHeight 或 ActualWidth 属性的值发生更改时发生。 (继承自 FrameworkElement) |
| SourceUpdated |
当此元素上的任何现有属性绑定的源值发生更改时发生。 (继承自 FrameworkElement) |
| StylusButtonDown |
在指针位于此元素上并且按下触笔按钮时发生。 (继承自 UIElement) |
| StylusButtonUp |
在指针位于此元素上并且松开触笔按钮时发生。 (继承自 UIElement) |
| StylusDown |
在触笔位于此元素上且同时触及数字化器时发生。 (继承自 UIElement) |
| StylusEnter |
在触笔进入此元素的边界时发生。 (继承自 UIElement) |
| StylusInAirMove |
在触笔掠过元素但并未实际接触数字化器时发生。 (继承自 UIElement) |
| StylusInRange |
在触笔位于此元素上并且触笔与数字化器之间的距离近到足以检测到触笔时发生。 (继承自 UIElement) |
| StylusLeave |
在触笔离开元素的边界时发生。 (继承自 UIElement) |
| StylusMove |
在触笔移到此元素上时发生。 触笔必须在位于数字化器上时移动，才会引发此事件。 否则将改为引发 StylusInAirMove。 (继承自 UIElement) |
| StylusOutOfRange |
在触笔位于此元素上并且触笔与数字化器之间的距离太远以致无法检测到触笔时发生。 (继承自 UIElement) |
| StylusSystemGesture |
在用户采用某一种触笔笔势时发生。 (继承自 UIElement) |
| StylusUp |
当触笔位于此元素上并且用户将触笔抬离数字化器时发生。 (继承自 UIElement) |
| TargetUpdated |
当此元素上的任何属性绑定的目标值发生更改时发生。 (继承自 FrameworkElement) |
| TextChanged |
在文本元素中的内容更改的情况下发生。 (继承自 TextBoxBase) |
| TextInput |
在此元素以设备无关模式获取文本时发生。 (继承自 UIElement) |
| ToolTipClosing |
在元素上的任何工具提示关闭之前发生。 (继承自 FrameworkElement) |
| ToolTipOpening |
在元素上的任何工具提示打开时发生。 (继承自 FrameworkElement) |
| TouchDown |
当悬停在此元素上方的手指触摸屏幕时发生。 (继承自 UIElement) |
| TouchEnter |
在触摸屏输入从此元素边界外部移动到其内部时发生。 (继承自 UIElement) |
| TouchLeave |
在触摸屏输入从此元素边界内部移动到其外部时发生。 (继承自 UIElement) |
| TouchMove |
当悬停在此元素上方的手指在屏幕上移动时发生。 (继承自 UIElement) |
| TouchUp |
当悬停在此元素上方的手指从屏幕上移开时发生。 (继承自 UIElement) |
| Unloaded |
当从加载的元素的元素树中移除元素时发生。 (继承自 FrameworkElement) |
显式接口实现
| IAddChild.AddChild(Object) |
此类型或成员支持 Windows Presentation Foundation (WPF) 基础结构，并且不应在代码中直接使用。 |
| IAddChild.AddText(String) |
此类型或成员支持 Windows Presentation Foundation (WPF) 基础结构，并且不应在代码中直接使用。 |
| IQueryAmbient.IsAmbientPropertyAvailable(String) |
有关此成员的说明，请参见 IsAmbientPropertyAvailable(String) 方法。 (继承自 FrameworkElement) |
