InkPresenter 类

定义

public ref class InkPresenter sealed

/// [Windows.Foundation.Metadata.ContractVersion(Windows.Foundation.UniversalApiContract, 65536)]
/// [Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
class InkPresenter final

[Windows.Foundation.Metadata.ContractVersion(typeof(Windows.Foundation.UniversalApiContract), 65536)]
[Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
public sealed class InkPresenter

Public NotInheritable Class InkPresenter

继承

Object Platform::Object IInspectable InkPresenter

属性

ContractVersionAttribute MarshalingBehaviorAttribute

Windows 要求

示例

下面，我们演示如何在图像上覆盖墨迹注释。 对于此示例，墨迹数据不会由相应的 InkPresenter 捕获或保存。

<ScrollViewer>
  <Grid>
    <Image Source="<path>"></Image>
    <InkCanvas x:Name="inkCanvas"></InkCanvas>
  </Grid>
</ScrollView

我们在此处将 InkPresenter 配置为将来自笔和鼠标的输入数据解释为墨迹笔划。 我们还将设置一些用于将笔划呈现到 InkCanvas 的初始墨迹笔划属性。

public MainPage()
{
    this.InitializeComponent();

    // Set supported inking device types.
    inkCanvas.InkPresenter.InputDeviceTypes = 
        Windows.UI.Core.CoreInputDeviceTypes.Mouse | 
        Windows.UI.Core.CoreInputDeviceTypes.Pen;

    // Set initial ink stroke attributes.
    InkDrawingAttributes drawingAttributes = new InkDrawingAttributes();
    drawingAttributes.Color = Windows.UI.Colors.Black;
    drawingAttributes.IgnorePressure = false;
    drawingAttributes.FitToCurve = true;
    inkCanvas.InkPresenter.UpdateDefaultDrawingAttributes(drawingAttributes);
}

可以动态设置墨迹笔划属性以适应用户首选项或应用要求。

此处，我们让用户从墨迹颜色列表中进行选择。

<Grid Background="{ThemeResource ApplicationPageBackgroundThemeBrush}">
    <Grid.RowDefinitions>
        <RowDefinition Height="Auto"/>
        <RowDefinition Height="*"/>
    </Grid.RowDefinitions>
    <StackPanel x:Name="HeaderPanel" Orientation="Horizontal" Grid.Row="0">
        <TextBlock x:Name="Header" 
                   Text="Basic ink customization sample" 
                   VerticalAlignment="Center"
                   Style="{ThemeResource HeaderTextBlockStyle}" 
                   Margin="10,0,0,0" />
        <TextBlock Text="Color:"
                   Style="{StaticResource SubheaderTextBlockStyle}"
                   VerticalAlignment="Center"
                   Margin="50,0,10,0"/>
        <ComboBox x:Name="PenColor"
                  VerticalAlignment="Center"
                  SelectedIndex="0"
                  SelectionChanged="OnPenColorChanged">
            <ComboBoxItem Content="Black"/>
            <ComboBoxItem Content="Red"/>
        </ComboBox>
    </StackPanel>
    <Grid Grid.Row="1">
        <Image Source="Assets\StoreLogo.png" />
        <InkCanvas x:Name="inkCanvas" />
    </Grid>
</Grid>

然后处理对所选颜色的更改并相应地更新墨迹笔划属性。

// Update ink stroke color for new strokes.
private void OnPenColorChanged(object sender, SelectionChangedEventArgs e)
{
    if (inkCanvas != null)
    {
        InkDrawingAttributes drawingAttributes = 
            inkCanvas.InkPresenter.CopyDefaultDrawingAttributes();

        string value = ((ComboBoxItem)PenColor.SelectedItem).Content.ToString();

        switch (value)
        {
            case "Black":
                drawingAttributes.Color = Windows.UI.Colors.Black;
                break;
            case "Red":
                drawingAttributes.Color = Windows.UI.Colors.Red;
                break;
            default:
                drawingAttributes.Color = Windows.UI.Colors.Black;
                break;
        };

        inkCanvas.InkPresenter.UpdateDefaultDrawingAttributes(drawingAttributes);
    }
}

注解

对于通用 Windows 应用，我们建议使用 InkPresenter 和 InkCanvas 控件，而不是 InkManager。

无法直接实例化 InkPresenter 类。 它作为 InkCanvas 对象的属性返回。

默认情况下，标准和修改墨迹输入完全由 InkPresenter 管理，并基于 InkInputProcessingConfiguration.Mode 以墨迹笔划或擦除笔划的形式呈现到 InkCanvas。

通过将 InkInputProcessingConfiguration.RightDragAction 设置为 InkInputRightDragAction.LeaveUnprocessed，可以将修改后的输入传递到应用进行处理。

通过将 InkInputProcessingConfiguration.Mode 设置为 None，可以将所有输入传递到应用进行处理。

使输入不受 InkPresenter 处理，可支持自定义墨迹体验和扩展功能，例如选择。

若要完全控制墨迹输入并将其呈现到通用 Windows 应用的 Direct2D 设备上下文，而不是默认的 InkCanvas 控件，请在加载 InkCanvas 之前调用 ActivateCustomDrying。 这需要 IInkD2DRenderer 对象来管理墨迹输入， (查看 复杂墨迹示例) 。

版本历史记录

属性

方法

事件

适用于

另请参阅

• 笔和触笔交互
• 入门：在 UWP 应用中支持墨迹
• 墨迹分析示例（基本）(C#)
• 墨迹手写识别示例 (C#)
• 保存并从墨迹序列化格式 (ISF) 文件加载笔划墨迹
• 保存并从剪贴板加载笔划墨迹
• 墨迹工具栏位置和方向示例（基本）
• 墨迹工具栏位置和方向示例（动态）
• Coloring Book 示例
• 系列说明示例
• JavaScript) (墨迹书写示例
• 简单墨迹书写示例 (C#/C++)
• 复杂墨迹书写示例 (C++)
• 墨迹分析示例