-api-id	-api-type
T:Windows.UI.Xaml.Controls.InkToolbarCustomPen	winrt class

Windows.UI.Xaml.Controls.InkToolbarCustomPen

-description

Represents an InkToolbar pen for which the ink color palette and pen tip properties, such as shape, rotation, and size, are defined by the host app.

To create an app-defined pen and corresponding button on the InkToolbar, use this class in conjunction with InkToolbarCustomPenButton.

Here's a definition of a custom calligraphic pen.

In code-behind, we first create a custom pen class derived from InkToolbarCustomPen.

A custom pen class must override the CreateInkDrawingAttributesCore method and provide the InkDrawingAttributes for the custom configuration. In this example, we customize the following InkDrawingAttributes:

PenTip is set to PenTipShape.Circle;
Size is set to a Windows.Foundation.Size of (strokeWidth, strokeWidth * 20).
Color is set to the SolidColorBrush selected from the palette, or Colors.Black by default.
PenTipTransform (through Matrix3x2.CreateRotation) is set to rotate the pen tip by 45°.

In markup, we then bind our custom pen class using a {StaticResource} markup extension reference in the CustomPen attribute of the InkToolbarCustomPenButton element (alternatively, you can instantiate the custom pen and assign it to InkToolbarCustomPenButton.CustomPen in code).

You can use the built-in InkToolbarPenConfigurationControl (as shown here) or you can specify a custom InkToolbarPenConfigurationControl definition in the standard InkToolbar pen declaration.

Here's the declaration for the custom pen defined in the previous snippet.

Here's the definition of CalligraphicPenIcon from the MainPage.xaml.cs file of this example.