InkToolbarCustomPen Klasse

Definition

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

Vererbung

Object Platform::Object IInspectable DependencyObject InkToolbarCustomPen

Attribute

ContractVersionAttribute MarshalingBehaviorAttribute ThreadingAttribute

Windows-Anforderungen

Beispiele

Im Folgenden finden Sie eine Definition eines benutzerdefinierten kalligrafischen Stifts.

1. Im CodeBehind erstellen wir zunächst eine benutzerdefinierte Stiftklasse, die von InkToolbarCustomPen abgeleitet ist.

Eine benutzerdefinierte Stiftklasse muss die CreateInkDrawingAttributesCore-Methode überschreiben und die InkDrawingAttributes für die benutzerdefinierte Konfiguration bereitstellen. In diesem Beispiel passen wir die folgenden InkDrawingAttributes an:

• PenTip ist auf PenTipShape.Circle festgelegt;
• Die Größe ist auf windows.Foundation.Size von (strokeWidth, strokeWidth * 20)festgelegt.
• Die Farbe ist auf den in der Palette ausgewählten SolidColorBrush oder standardmäßig auf Colors.Black festgelegt.
• PenTipTransform (über Matrix3x2.CreateRotation) ist so festgelegt, dass die Stiftspitze um 45° gedreht wird.

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. Im Markup binden wir dann unsere benutzerdefinierte Stiftklasse mithilfe eines {StaticResource}-Markuperweiterungsverweis im CustomPen-Attribut des InkToolbarCustomPenButton-Elements (alternativ können Sie den benutzerdefinierten Stift instanziieren und ihn im Code InkToolbarCustomPenButton.CustomPen zuweisen).

Sie können das integrierte InkToolbarPenConfigurationControl verwenden (wie hier gezeigt), oder Sie können eine benutzerdefinierte InkToolbarPenConfigurationControl-Definition in der standardmäßigen InkToolbar-Stiftdeklaration angeben.

Dies ist die Deklaration für den benutzerdefinierten Stift, der im vorherigen Codeausschnitt definiert wurde.

<!-- 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>

Dies ist die Definition von CalligraphicPenIcon aus der MainPage.xaml.cs Datei dieses Beispiels.

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();
        }
    }
}

Hinweise

Um einen app-definierten Stift und eine entsprechende Schaltfläche auf der InkToolbar zu erstellen, verwenden Sie diese Klasse in Verbindung mit InkToolbarCustomPenButton.

Konstruktoren

Eigenschaften

Methoden

Gilt für:

Weitere Informationen

• InkToolbarPenButton
• InkToolbarCustomPenButton
• DependencyObject
• Zeichen- und Eingabestiftinteraktionen
• Hinzufügen einer InkToolbar zu einer Universelle Windows-Plattform-App (UWP)
• Tutorial zu den ersten Schritten: Freihandunterstützung in Ihrer UWP-App
• Windows.UI.Xaml.Controls-Klassen
• Freihandbeispiel (JavaScript)
• Tutorial zu den ersten Schritten: Freihandunterstützung in Ihrer UWP-App
• Malbuchbeispiel
• Familiennotizbeispiel