InkToolbarCustomPen Classe

Definição

public ref class InkToolbarCustomPen : DependencyObject

/// [Windows.Foundation.Metadata.ContractVersion(Windows.Foundation.UniversalApiContract, 196608)]
/// [Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
/// [Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
class InkToolbarCustomPen : DependencyObject

[Windows.Foundation.Metadata.ContractVersion(typeof(Windows.Foundation.UniversalApiContract), 196608)]
[Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
[Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
public class InkToolbarCustomPen : DependencyObject

Public Class InkToolbarCustomPen
Inherits DependencyObject

Herança

Object Platform::Object IInspectable DependencyObject InkToolbarCustomPen

Atributos

ContractVersionAttribute MarshalingBehaviorAttribute ThreadingAttribute

Requisitos do Windows

Exemplos

Aqui está uma definição de uma caneta calligraphic personalizada.

1. No code-behind, primeiro criamos uma classe de caneta personalizada derivada de InkToolbarCustomPen.

Uma classe de caneta personalizada deve substituir o método CreateInkDrawingAttributesCore e fornecer InkDrawingAttributes para a configuração personalizada. Neste exemplo, personalizamos os seguintes InkDrawingAttributes:

• PenTip é definido como PenTipShape.Circle;
• O tamanho é definido como um Windows.Foundation.Size de (strokeWidth, strokeWidth * 20).
• A cor é definida como o SolidColorBrush selecionado na paleta ou Colors.Black por padrão.
• PenTipTransform (por meio de Matrix3x2.CreateRotation) é definido para girar a ponta da caneta em 45°.

using System.Numerics;
using Windows.UI;
using Windows.UI.Input.Inking;
using Windows.UI.Xaml.Controls;
using Windows.UI.Xaml.Media;

namespace Ink_Basic_InkToolbar
{
    class CalligraphicPen : InkToolbarCustomPen
    {

        public CalligraphicPen()
        {
        }

        protected override InkDrawingAttributes CreateInkDrawingAttributesCore(Brush brush, double strokeWidth)
        {
            InkDrawingAttributes inkDrawingAttributes = new InkDrawingAttributes();
            inkDrawingAttributes.PenTip = PenTipShape.Circle;
            inkDrawingAttributes.Size = new Windows.Foundation.Size(strokeWidth, strokeWidth * 20);
            SolidColorBrush solidColorBrush = brush as SolidColorBrush;
            if (solidColorBrush != null)
            {
                inkDrawingAttributes.Color = solidColorBrush.Color;
            }
            else
            {
                inkDrawingAttributes.Color = Colors.Black;
            }
            Matrix3x2 matrix = Matrix3x2.CreateRotation(.785f);
            inkDrawingAttributes.PenTipTransform = matrix;

            return inkDrawingAttributes;
        }
    }
}

1. Na marcação, associamos nossa classe de caneta personalizada usando uma referência de extensão de marcação {StaticResource} no atributo CustomPen do elemento InkToolbarCustomPenButton (como alternativa, você pode instanciar a caneta personalizada e atribuí-la a InkToolbarCustomPenButton.CustomPen no código).

Você pode usar o InkToolbarPenConfigurationControl interno (conforme mostrado aqui) ou pode especificar uma definição inkToolbarPenConfigurationControl personalizada na declaração de caneta InkToolbar padrão.

Aqui está a declaração para a caneta personalizada definida no snippet anterior.

<!-- Set up locally defined resource dictionary. -->
<Page.Resources>
    <!-- Add the custom CalligraphicPen to the page resources. -->
    <local:CalligraphicPen x:Key="CalligraphicPen" />
    <!-- Specify the colors for the palette of the custom pen. -->
    <BrushCollection x:Key="CalligraphicPenPalette">
        <SolidColorBrush Color="Blue" />
        <SolidColorBrush Color="Red" />
    </BrushCollection>
</Page.Resources>

<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 sample" 
                   Style="{ThemeResource HeaderTextBlockStyle}" 
                   Margin="10,0,0,0" />
    </StackPanel>
    <Grid Grid.Row="1">
        <Image Source="Assets\StoreLogo.png" />
        <InkCanvas x:Name="inkCanvas" />
        <InkToolbar x:Name="inkToolbar" 
                    VerticalAlignment="Top" 
                    TargetInkCanvas="{x:Bind inkCanvas}">
            <InkToolbarCustomPenButton 
                CustomPen="{StaticResource CalligraphicPen}"
                MinStrokeWidth="1" MaxStrokeWidth="3" SelectedStrokeWidth="2"
                Palette="{StaticResource CalligraphicPenPalette}"
                SelectedBrushIndex ="1"
                ToolTipService.ToolTip="Calligraphic pen">                    
                <SymbolIcon Symbol="{x:Bind CalligraphicPenIcon}"/>                    
                <InkToolbarCustomPenButton.ConfigurationContent>
                    <InkToolbarPenConfigurationControl />
                </InkToolbarCustomPenButton.ConfigurationContent>
            </InkToolbarCustomPenButton>                
        </InkToolbar>
    </Grid>
</Grid>

Aqui está a definição de CalligraphicPenIcon do MainPage.xaml.cs arquivo deste exemplo.

namespace Ink_Basic_InkToolbar
{
    /// <summary>
    /// An empty page that can be used on its own or navigated to within a Frame.
    /// </summary>
    public sealed partial class MainPage_AddCustomPen : Page
    {
        // Icon for calligraphic pen custom button.
        Symbol CalligraphicPenIcon = (Symbol)0xEDFB;

        public MainPage_AddCustomPen()
        {
            this.InitializeComponent();
        }
    }
}

Comentários

Para criar uma caneta definida pelo aplicativo e um botão correspondente no InkToolbar, use essa classe em conjunto com InkToolbarCustomPenButton.

Construtores

Propriedades

Métodos

Aplica-se a

Confira também

• InkToolbarPenButton
• InkToolbarCustomPenButton
• DependencyObject
• Interações por caneta
• Adicionar um InkToolbar a um aplicativo UWP (Plataforma Universal do Windows)
• Tutorial de Introdução: oferecer suporte à tinta em seu aplicativo UWP
• Classes Windows.UI.Xaml.Controls
• Exemplo de tinta (JavaScript)
• Tutorial de Introdução: oferecer suporte à tinta em seu aplicativo UWP
• Exemplo de livro de colorir
• Exemplo de anotações da família