InkCanvas 类
定义
重要
一些信息与预发行产品相关，相应产品在发行之前可能会进行重大修改。 对于此处提供的信息，Microsoft 不作任何明示或暗示的担保。
定义接收和显示墨迹笔划的区域。
public ref class InkCanvas : System::Windows::FrameworkElement, System::Windows::Markup::IAddChild[System.Windows.Markup.ContentProperty("Children")]
public class InkCanvas : System.Windows.FrameworkElement, System.Windows.Markup.IAddChild[<System.Windows.Markup.ContentProperty("Children")>]
type InkCanvas = class
inherit FrameworkElement
interface IAddChildPublic Class InkCanvas
Inherits FrameworkElement
Implements IAddChild- 继承
- 属性
- 实现
示例
以下示例演示如何在同一 个 上模拟笔和荧光笔的使用 InkCanvas。 该示例假定 XAML) 文件中标记语言 (根元素是一个名为 DockPanel 的 root。 它还假定有 一个 Button 调用 switchHighlighter ， Click 并且 和 Loaded 事件都连接到示例的事件处理程序。
InkCanvas inkCanvas1 = new InkCanvas();
DrawingAttributes inkDA;
DrawingAttributes highlighterDA;
bool useHighlighter = false;
// Add an InkCanvas to the window, and allow the user to
// switch between using a green pen and a purple highlighter
// on the InkCanvas.
private void WindowLoaded(object sender, EventArgs e)
{
inkCanvas1.Background = Brushes.DarkSlateBlue;
inkCanvas1.DefaultDrawingAttributes.Color = Colors.SpringGreen;
root.Children.Add(inkCanvas1);
// Set up the DrawingAttributes for the pen.
inkDA = new DrawingAttributes();
inkDA.Color = Colors.SpringGreen;
inkDA.Height = 5;
inkDA.Width = 5;
inkDA.FitToCurve = false;
// Set up the DrawingAttributes for the highlighter.
highlighterDA = new DrawingAttributes();
highlighterDA.Color = Colors.Orchid;
highlighterDA.IsHighlighter = true;
highlighterDA.IgnorePressure = true;
highlighterDA.StylusTip = StylusTip.Rectangle;
highlighterDA.Height = 30;
highlighterDA.Width = 10;
inkCanvas1.DefaultDrawingAttributes = inkDA;
}
// Create a button called switchHighlighter and use
// SwitchHighlighter_Click to handle the Click event.
// The useHighlighter variable is a boolean that indicates
// whether the InkCanvas renders ink as a highlighter.
// Switch between using the 'pen' DrawingAttributes and the
// 'highlighter' DrawingAttributes.
void SwitchHighlighter_Click(Object sender, RoutedEventArgs e)
{
useHighlighter = !useHighlighter;
if (useHighlighter)
{
switchHighlighter.Content = "Use Pen";
inkCanvas1.DefaultDrawingAttributes = highlighterDA;
}
else
{
switchHighlighter.Content = "Use Highlighter";
inkCanvas1.DefaultDrawingAttributes = inkDA;
}
}
Private WithEvents inkCanvas1 As New InkCanvas()
Private inkDA As DrawingAttributes
Private highlighterDA As DrawingAttributes
Private useHighlighter As Boolean = False
' Add an InkCanvas to the window, and allow the user to
' switch between using a green pen and a purple highlighter
' on the InkCanvas.
Private Sub WindowLoaded(ByVal sender As Object, ByVal e As RoutedEventArgs)
inkCanvas1.Background = Brushes.DarkSlateBlue
inkCanvas1.DefaultDrawingAttributes.Color = Colors.SpringGreen
' Add the InkCanvas to the DockPanel, named root.
root.Children.Add(inkCanvas1)
' Set up the DrawingAttributes for the pen.
inkDA = New DrawingAttributes()
With inkDA
.Color = Colors.SpringGreen
.Height = 5
.Width = 5
.FitToCurve = True
End With
' Set up the DrawingAttributes for the highlighter.
highlighterDA = New DrawingAttributes()
With highlighterDA
.Color = Colors.Orchid
.IsHighlighter = True
.IgnorePressure = True
.StylusTip = StylusTip.Rectangle
.Height = 30
.Width = 10
End With
inkCanvas1.DefaultDrawingAttributes = inkDA
End Sub
' Create a button called switchHighlighter and use
' SwitchHighlighter_Click to handle the Click event.
' The useHighlighter variable is a boolean that indicates
' whether the InkCanvas renders ink as a highlighter.
' Switch between using the 'pen' DrawingAttributes and the
' 'highlighter' DrawingAttributes when the user clicks on .
Private Sub SwitchHighlighter_Click(ByVal sender As [Object], ByVal e As RoutedEventArgs)
useHighlighter = Not useHighlighter
If useHighlighter Then
switchHighlighter.Content = "Use Pen"
inkCanvas1.DefaultDrawingAttributes = highlighterDA
Else
switchHighlighter.Content = "Use Highlighter"
inkCanvas1.DefaultDrawingAttributes = inkDA
End If
End Sub
以下示例声明 XAML 中的两个 InkCanvas 对象，并在这两个对象和其他数据源之间建立数据绑定。 第一个名为 ic 的 InkCanvas 绑定到两个数据源。 上的 EditingModeic 和 DefaultDrawingAttributes 属性绑定到 ListBox 对象，这些对象又绑定到 XAML 中定义的数组。 第EditingMode二InkCanvas个的 、 DefaultDrawingAttributes和 Strokes 属性绑定到以下代码中的第一个InkCanvas。
<Canvas>
<Canvas.Resources>
<!--Define an array containing the InkEditingMode Values.-->
<x:Array x:Key="MyEditingModes" x:Type="{x:Type InkCanvasEditingMode}">
<x:Static Member="InkCanvasEditingMode.Ink"/>
<x:Static Member="InkCanvasEditingMode.Select"/>
<x:Static Member="InkCanvasEditingMode.EraseByPoint"/>
<x:Static Member="InkCanvasEditingMode.EraseByStroke"/>
</x:Array>
<!--Define an array containing some DrawingAttributes.-->
<x:Array x:Key="MyDrawingAttributes"
x:Type="{x:Type DrawingAttributes}">
<DrawingAttributes Color="Black" FitToCurve="true"
Width="3" Height="3"/>
<DrawingAttributes Color="Blue" FitToCurve="false"
Width="5" Height="5"/>
<DrawingAttributes Color="Red" FitToCurve="true"
Width="7" Height="7"/>
</x:Array>
<!--Create a DataTemplate to display the
DrawingAttributes shown above-->
<DataTemplate DataType="{x:Type DrawingAttributes}" >
<Border Width="80" Height="{Binding Path=Height}">
<Border.Background >
<SolidColorBrush Color="{Binding Path=Color}"/>
</Border.Background>
</Border>
</DataTemplate>
</Canvas.Resources>
<!--Bind the first InkCavas' DefaultDrawingAtributes to a
Listbox, called lbDrawingAttributes, and its EditingMode to
a ListBox called lbEditingMode.-->
<InkCanvas Name="ic" Background="LightGray"
Canvas.Top="0" Canvas.Left="0"
Height="400" Width="200"
DefaultDrawingAttributes="{Binding
ElementName=lbDrawingAttributes, Path=SelectedItem}"
EditingMode=
"{Binding ElementName=lbEditingMode, Path=SelectedItem}"
>
</InkCanvas>
<!--Bind the Strokes, DefaultDrawingAtributes, and, EditingMode properties of
the second InkCavas the first InkCanvas.-->
<InkCanvas Background="LightBlue"
Canvas.Top="0" Canvas.Left="200"
Height="400" Width="200"
Strokes="{Binding ElementName=ic, Path=Strokes}"
DefaultDrawingAttributes="{Binding
ElementName=ic, Path=DefaultDrawingAttributes}"
EditingMode="{Binding ElementName=ic, Path=EditingMode}">
<InkCanvas.LayoutTransform>
<ScaleTransform ScaleX="-1" ScaleY="1" />
</InkCanvas.LayoutTransform>
</InkCanvas>
<!--Use the array, MyEditingModes, to populate a ListBox-->
<ListBox Name="lbEditingMode"
Canvas.Top="0" Canvas.Left="450"
Height="100" Width="100"
ItemsSource="{StaticResource MyEditingModes}" />
<!--Use the array, MyDrawingAttributes, to populate a ListBox-->
<ListBox Name="lbDrawingAttributes"
Canvas.Top="150" Canvas.Left="450"
Height="100" Width="100"
ItemsSource="{StaticResource MyDrawingAttributes}" />
</Canvas>
注解
是 InkCanvas 可用于接收和显示墨迹输入的元素。 这通常通过使用触笔来完成，触笔与数字化器交互，以使用触笔或鼠标生成墨迹笔划。 创建的笔划表示为 Stroke 对象，可以通过编程方式或基于用户输入进行操作。 InkCanvas使用户能够修改或删除现有的 Stroke。
InkCanvas可以绑定到数据源。 例如，可以将 属性绑定到 Strokes ：一个 base-64 编码字符串，其中包含墨迹序列化格式的墨迹数据 (ISF) ;甚至绑定到 Strokes 另一个 InkCanvas的 属性。 还可以将 和 EditingMode等DefaultDrawingAttributes属性绑定到其他数据源。
构造函数
| InkCanvas() |
初始化 InkCanvas 类的一个新实例。 |
字段
| ActiveEditingModeChangedEvent |
标识 ActiveEditingModeChanged 路由事件。 |
| ActiveEditingModeProperty |
标识 ActiveEditingMode 依赖项属性。 |
| BackgroundProperty |
标识 Background 依赖项属性。 |
| BottomProperty |
标识 Bottom 附加属性。 |
| DefaultDrawingAttributesProperty |
标识 DefaultDrawingAttributes 依赖项属性。 |
| EditingModeChangedEvent |
标识 EditingModeChanged 路由事件。 |
| EditingModeInvertedChangedEvent |
标识 EditingModeInvertedChanged 路由事件。 |
| EditingModeInvertedProperty |
标识 EditingModeInverted 依赖项属性。 |
| EditingModeProperty |
标识 EditingMode 依赖项属性。 |
| GestureEvent |
标识 Gesture 路由事件。 |
| LeftProperty |
标识 Left 附加属性。 |
| RightProperty |
标识 Right 附加属性。 |
| StrokeCollectedEvent |
标识 StrokeCollected 路由事件。 |
| StrokeErasedEvent |
标识 StrokeErased 路由事件。 |
| StrokesProperty |
标识 Strokes 依赖项属性。 |
| TopProperty |
标识 Top 附加属性。 |
属性
| ActiveEditingMode |
获取 InkCanvas 的当前编辑模式。 |
| ActualHeight |
获取此元素的呈现高度。 (继承自 FrameworkElement) |
| ActualWidth |
获取此元素的呈现宽度。 (继承自 FrameworkElement) |
| AllowDrop |
获取或设置一个值，该值指示此元素能否用作拖放操作的目标。 这是依赖项属性。 (继承自 UIElement) |
| AreAnyTouchesCaptured |
获取一个值，该值指示在此元素上是否至少捕获了一次触摸。 (继承自 UIElement) |
| AreAnyTouchesCapturedWithin |
获取一个值，该值指示在此元素或其可视化树中的任何子元素上是否至少捕获了一次触摸。 (继承自 UIElement) |
| AreAnyTouchesDirectlyOver |
获取一个值，该值指示在此元素上是否至少按下了一次触摸设备。 (继承自 UIElement) |
| AreAnyTouchesOver |
获取一个值，该值指示在此元素或其可视化树中的任何子元素上是否至少按下了一次触摸设备。 (继承自 UIElement) |
| Background | |
| BindingGroup |
获取或设置用于该元素的 BindingGroup。 (继承自 FrameworkElement) |
| BitmapEffect |
已过时.
已过时.
获取或设置一个位图效果，该效果将直接应用到此元素所呈现的内容。 这是依赖项属性。 (继承自 UIElement) |
| BitmapEffectInput |
已过时.
已过时.
获取或设置位图效果的输入源，该效果将直接应用到此元素所呈现的内容。 这是依赖项属性。 (继承自 UIElement) |
| CacheMode |
获取或设置 UIElement 的缓存表示形式。 (继承自 UIElement) |
| Children |
检索 InkCanvas 的子元素。 |
| Clip |
获取或设置用于定义元素内容轮廓的几何图形。 这是依赖项属性。 (继承自 UIElement) |
| ClipToBounds |
获取或设置一个值，该值指示是否剪切此元素的内容(或来自此元素的子元素的内容)使其适合包含元素的大小。 这是依赖项属性。 (继承自 UIElement) |
| CommandBindings |
获取与此元素关联的 CommandBinding 对象的集合。 CommandBinding 为此元素启用命令处理，并声明命令、命令的事件和由此元素附加的处理程序之间的链接。 (继承自 UIElement) |
| ContextMenu |
获取或设置上下文菜单元素，每当通过用户界面 (UI) 此元素内请求上下文菜单时，应显示该元素。 (继承自 FrameworkElement) |
| Cursor |
获取或设置在鼠标指针位于此元素上时显示的光标。 (继承自 FrameworkElement) |
| DataContext |
获取或设置元素参与数据绑定时的数据上下文。 (继承自 FrameworkElement) |
| DefaultDrawingAttributes |
获取或设置应用于在 InkCanvas 上绘制的新墨迹笔画的绘制特性。 |
| DefaultStyleKey |
获取或设置在使用或定义主题样式时要用于引用此控件样式的键。 (继承自 FrameworkElement) |
| DefaultStylusPointDescription |
获取或设置 InkCanvas 的触笔点说明。 |
| DependencyObjectType |
获取 DependencyObjectType 包装此实例的 CLR 类型的 。 (继承自 DependencyObject) |
| DesiredSize |
获取在布局流程的度量传递过程中此元素计算所得的大小。 (继承自 UIElement) |
| Dispatcher |
获取与此 Dispatcher 关联的 DispatcherObject。 (继承自 DispatcherObject) |
| DynamicRenderer |
获取或设置在 InkCanvas 上动态绘制墨迹的呈现器。 |
| EditingMode |
获取或设置活动指针设备使用的用户编辑模式。 |
| EditingModeInverted |
如果触笔在与 InkCanvas 交互时发生反转，则获取或设置用户编辑模式。 |
| Effect |
获取或设置要应用于 UIElement 的位图效果。 这是依赖项属性。 (继承自 UIElement) |
| EraserShape |
获取或设置用来按点擦除 StylusShape 中墨迹的 InkCanvas。 |
| FlowDirection |
获取或设置文本和其他用户界面 (UI) 元素在控制其布局的任何父元素内流动的方向。 (继承自 FrameworkElement) |
| Focusable |
获取或设置一个值，该值指示元素能否得到焦点。 这是依赖项属性。 (继承自 UIElement) |
| FocusVisualStyle |
获取或设置一个属性，该属性允许自定义此元素在捕获到键盘焦点时要应用于此元素的外观、效果或其他样式特征。 (继承自 FrameworkElement) |
| ForceCursor |
获取或设置一个值，该值指示是否 FrameworkElement 应强制用户界面 (UI) 呈现由 属性声明的 Cursor 光标。 (继承自 FrameworkElement) |
| HasAnimatedProperties |
获取一个值，该值指示此元素是否具有任何进行动画处理的属性。 (继承自 UIElement) |
| HasEffectiveKeyboardFocus |
获取一个值，该值指示 UIElement 是否具有焦点。 (继承自 UIElement) |
| Height |
获取或设置元素的建议高度。 (继承自 FrameworkElement) |
| HorizontalAlignment |
获取或设置在父元素(如 Panel 或项控件)中组合此元素时所应用的水平对齐特征。 (继承自 FrameworkElement) |
| InheritanceBehavior |
获取或设置属性值继承、资源键查找和RelativeSource FindAncestor 查找的范围限制。 (继承自 FrameworkElement) |
| InkPresenter |
获取在 InkCanvas 上显示墨迹的墨迹显示器。 |
| InputBindings |
获取与此元素关联的输入绑定的集合。 (继承自 UIElement) |
| InputScope |
获取或设置此 FrameworkElement 使用的输入的上下文。 (继承自 FrameworkElement) |
| IsArrangeValid |
获取一个值，该值指示此元素布局中的子元素的计算大小和位置是否有效。 (继承自 UIElement) |
| IsEnabled |
获取或设置一个值，该值指示是否在用户界面 (UI) 中启用此元素。 这是依赖项属性。 (继承自 UIElement) |
| IsEnabledCore |
获取一个值，该值成为派生类中 IsEnabled 的返回值。 (继承自 UIElement) |
| IsFocused |
获取一个值，该值确定此元素是否具有逻辑焦点。 这是依赖项属性。 (继承自 UIElement) |
| IsGestureRecognizerAvailable |
获取（确定）笔势识别组件在用户系统上是否可用。 |
| IsHitTestVisible |
获取或设置一个值，该值声明是否可以返回此元素作为其呈现内容的某些部分的点击测试结果。 这是依赖项属性。 (继承自 UIElement) |
| 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) |
| IsSealed |
获取一个值，该值指示此实例当前是否为密封的（只读）。 (继承自 DependencyObject) |
| IsStylusCaptured |
获取一个值，该值表示此元素是否捕获了触笔。 这是依赖项属性。 (继承自 UIElement) |
| IsStylusCaptureWithin |
获取一个值，该值确定触笔捕获是由此元素还是由元素边界内的元素及其可视化树持有。 这是依赖项属性。 (继承自 UIElement) |
| IsStylusDirectlyOver |
获取一个值，该值指示在考虑元素组合的情况下，触笔的位置是否与命中测试结果相对应。 这是依赖项属性。 (继承自 UIElement) |
| IsStylusOver |
获取一个值，该值指示触笔指针是否位于此元素（包括可视化子元素）的上方。 这是依赖项属性。 (继承自 UIElement) |
| IsVisible |
获取一个值，该值指示此元素在用户界面 (UI) 中是否可见。 这是依赖项属性。 (继承自 UIElement) |
| Language |
获取或设置应用于某个元素的本地化/全球化语言信息。 (继承自 FrameworkElement) |
| LayoutTransform |
获取或设置在执行布局时应用于此元素的图形转换。 (继承自 FrameworkElement) |
| LogicalChildren |
返回用于逻辑子级的枚举器。 |
| Margin |
获取或设置元素的外边距。 (继承自 FrameworkElement) |
| MaxHeight |
获取或设置元素的最大高度约束。 (继承自 FrameworkElement) |
| MaxWidth |
获取或设置元素的最大宽度约束。 (继承自 FrameworkElement) |
| MinHeight |
获取或设置元素的最小高度约束。 (继承自 FrameworkElement) |
| MinWidth |
获取或设置元素的最小宽度约束。 (继承自 FrameworkElement) |
| MoveEnabled |
获取或设置一个布尔值，该值指示是否允许用户移动 InkCanvas 上选定的墨迹笔画和/或元素。 |
| Name |
获取或设置元素的标识名称。 该名称提供引用，以便代码隐藏（如事件处理程序代码）可以在 XAML 处理器处理期间构造标记元素后引用它。 (继承自 FrameworkElement) |
| Opacity |
获取或设置在用户界面 (UI) 呈现时应用于整个 UIElement 的不透明度因子。 这是依赖项属性。 (继承自 UIElement) |
| OpacityMask |
获取或设置一个作为 Brush 实现的不透明蒙板，该蒙板可应用到此元素所呈现内容的任何 Alpha 通道蒙板。 这是依赖项属性。 (继承自 UIElement) |
| OverridesDefaultStyle |
获取或设置一个值，该值指示此元素是否并入主题样式中的样式属性。 (继承自 FrameworkElement) |
| Parent |
获取此元素的逻辑父元素。 (继承自 FrameworkElement) |
| PersistId |
已过时.
获取一个唯一标识此元素的值。 (继承自 UIElement) |
| PreferredPasteFormats |
获取或设置可粘贴到 InkCanvas 中的格式。 |
| RenderSize |
获取（或设置）此元素的最终呈现大小。 (继承自 UIElement) |
| RenderTransform |
获取或设置影响此元素的呈现位置的转换信息。 这是依赖项属性。 (继承自 UIElement) |
| RenderTransformOrigin |
获取或设置由 RenderTransform 声明的任何可能呈现转换的中心点，相对于元素的边界。 这是依赖项属性。 (继承自 UIElement) |
| ResizeEnabled |
获取或设置一个布尔值，该值指示用户是否可以调整 InkCanvas 上选定的墨迹笔画和/或元素的大小。 |
| Resources |
获取或设置本地定义的资源字典。 (继承自 FrameworkElement) |
| SnapsToDevicePixels |
获取或设置一个值，该值确定在呈现过程中，此元素的呈现是否应使用特定于设备的像素设置。 这是依赖项属性。 (继承自 UIElement) |
| Strokes | |
| Style |
获取或设置此元素呈现时所使用的样式。 (继承自 FrameworkElement) |
| StylusPlugIns |
获取与此元素关联的所有触笔插件（自定义）对象的集合。 (继承自 UIElement) |
| Tag |
获取或设置任意对象值，该值可用于存储关于此元素的自定义信息。 (继承自 FrameworkElement) |
| TemplatedParent |
获取对此元素的模板父级的引用。 如果该元素不是通过模板创建的，则此属性无关。 (继承自 FrameworkElement) |
| ToolTip |
获取或设置用户界面 (UI) 中为此元素显示的工具提示对象。 (继承自 FrameworkElement) |
| TouchesCaptured |
获取在此元素上捕获的所有触摸设备。 (继承自 UIElement) |
| TouchesCapturedWithin |
获取在此元素或其可视化树中的任何子元素上捕获的所有触摸设备。 (继承自 UIElement) |
| TouchesDirectlyOver |
获取此元素上的所有触摸设备。 (继承自 UIElement) |
| TouchesOver |
获取在此元素或其可视化树中的任何子元素上的所有触摸设备。 (继承自 UIElement) |
| Triggers |
获取直接在此元素上或在子元素中建立的触发器的集合。 (继承自 FrameworkElement) |
| Uid |
获取或设置此元素的唯一标识符（用于本地化）。 这是依赖项属性。 (继承自 UIElement) |
| UseCustomCursor |
获取或设置一个布尔值，该值指示是否重写标准的 InkCanvas 光标功能以支持自定义光标。 |
| UseLayoutRounding |
获取或设置一个值，该值指示是否应向此元素的大小和位置布局应用布局舍入。 (继承自 FrameworkElement) |
| VerticalAlignment |
获取或设置在父元素（如面板或项控件）中组合此元素时所应用的垂直对齐特征。 (继承自 FrameworkElement) |
| Visibility |
获取或设置用户界面 (UI) 此元素的可见性。 这是依赖项属性。 (继承自 UIElement) |
| VisualBitmapEffect |
已过时.
已过时.
获取或设置 BitmapEffect 的 Visual 值。 (继承自 Visual) |
| VisualBitmapEffectInput |
已过时.
已过时.
获取或设置 BitmapEffectInput 的 Visual 值。 (继承自 Visual) |
| VisualBitmapScalingMode |
获取或设置 BitmapScalingMode 的 Visual。 (继承自 Visual) |
| VisualCacheMode |
获取或设置 Visual 的缓存表示形式。 (继承自 Visual) |
| VisualChildrenCount |
获取此元素内可视子元素的数目。 |
| 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) |
附加属性
| Bottom |
获取或设置某元素的下边缘与其父 InkCanvas 的下边缘之间的距离。 |
| Left |
获取或设置某元素的左边缘与其父 InkCanvas 的左边缘之间的距离。 |
| Right |
获取或设置某元素的右边缘与其父 InkCanvas 的右边缘之间的距离。 |
| Top |
获取或设置某元素的上边缘与其父 InkCanvas 的上边缘之间的距离。 |
方法
事件
| ActiveEditingModeChanged |
在当前编辑模式改变时发生。 |
| ContextMenuClosing |
在元素上的任何上下文菜单关闭之前发生。 (继承自 FrameworkElement) |
| ContextMenuOpening |
在元素上的任何上下文菜单打开时发生。 (继承自 FrameworkElement) |
| DataContextChanged |
在此元素的数据上下文更改时发生。 (继承自 FrameworkElement) |
| DefaultDrawingAttributesReplaced |
在替换 DefaultDrawingAttributes 属性时发生。 |
| DragEnter |
在输入系统报告出现以此元素为拖动目标的基础拖动事件时发生。 (继承自 UIElement) |
| DragLeave |
在输入系统报告出现以此元素为拖动起点的基础拖动事件时发生。 (继承自 UIElement) |
| DragOver |
在输入系统报告出现以此元素为可能放置目标的基础拖动事件时发生。 (继承自 UIElement) |
| Drop |
在输入系统报告出现将此元素作为放置目标的基础放置事件时发生。 (继承自 UIElement) |
| EditingModeChanged |
在 EditingMode 对象的 InkCanvas 属性更改后发生。 |
| EditingModeInvertedChanged |
在 EditingModeInverted 对象的 InkCanvas 属性更改后发生。 |
| FocusableChanged |
当 Focusable 属性的值更改时发生。 (继承自 UIElement) |
| Gesture |
在 InkCanvas 检测到笔势时发生。 |
| 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) |
| 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) |
| 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 |
在 InkCanvas 上的选择更改时发生。 |
| SelectionChanging |
在选择了一组新墨迹笔画和/或元素时发生。 |
| SelectionMoved |
在用户移动了所选笔画和/或元素之后发生。 |
| SelectionMoving |
在移动选定笔画和元素之前发生。 |
| SelectionResized |
在用户调整了所选笔画和/或元素大小时发生。 |
| SelectionResizing |
在调整选定笔画和元素的大小之前发生。 |
| SizeChanged |
当此元素上的 ActualHeight 或 ActualWidth 属性的值发生更改时发生。 (继承自 FrameworkElement) |
| SourceUpdated |
当此元素上的任何现有属性绑定的源值发生更改时发生。 (继承自 FrameworkElement) |
| StrokeCollected |
在将用户绘制的笔画添加到 Strokes 属性时发生。 |
| StrokeErased |
在用户擦除笔画时发生。 |
| StrokeErasing |
恰好在用户擦除笔画之前发生。 |
| StrokesReplaced |
在替换 Strokes 属性时发生。 |
| 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) |
| TextInput |
在此元素以设备无关模式获取文本时发生。 (继承自 UIElement) |
| ToolTipClosing |
在元素上的任何工具提示关闭之前发生。 (继承自 FrameworkElement) |
| ToolTipOpening |
在元素上的任何工具提示打开时发生。 (继承自 FrameworkElement) |
| TouchDown |
当悬停在此元素上方的手指触摸屏幕时发生。 (继承自 UIElement) |
| TouchEnter |
在触摸屏输入从此元素边界外部移动到其内部时发生。 (继承自 UIElement) |
| TouchLeave |
在触摸屏输入从此元素边界内部移动到其外部时发生。 (继承自 UIElement) |
| TouchMove |
当悬停在此元素上方的手指在屏幕上移动时发生。 (继承自 UIElement) |
| TouchUp |
当悬停在此元素上方的手指从屏幕上移开时发生。 (继承自 UIElement) |
| Unloaded |
当从加载的元素的元素树中移除元素时发生。 (继承自 FrameworkElement) |
显式接口实现
| IAddChild.AddChild(Object) |
将指定的对象添加到 InkCanvas 中。 |
| IAddChild.AddText(String) |
添加位于标记内的文本。 始终引发一个 ArgumentException。 |
| IQueryAmbient.IsAmbientPropertyAvailable(String) |
有关此成员的说明，请参见 IsAmbientPropertyAvailable(String) 方法。 (继承自 FrameworkElement) |
