InkToolbarCustomPen 클래스
정의
중요
일부 정보는 릴리스되기 전에 상당 부분 수정될 수 있는 시험판 제품과 관련이 있습니다. Microsoft는 여기에 제공된 정보에 대해 어떠한 명시적이거나 묵시적인 보증도 하지 않습니다.
잉크 색상표와 펜 팁 속성(예: 도형, 회전 및 크기)이 호스트 앱에서 정의되는 InkToolbar 펜을 나타냅니다.
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 : DependencyObjectPublic Class InkToolbarCustomPen
Inherits DependencyObject- 상속
- 특성
Windows 요구 사항
| 디바이스 패밀리 |
Windows 10 Anniversary Edition (10.0.14393.0에서 도입되었습니다.)
|
| API contract |
Windows.Foundation.UniversalApiContract (v3.0에서 도입되었습니다.)
|
예제
사용자 지정 서예 펜의 정의는 다음과 같습니다.
- 코드 숨김에서는 먼저 InkToolbarCustomPen에서 파생된 사용자 지정 펜 클래스를 만듭니다.
사용자 지정 펜 클래스는 CreateInkDrawingAttributesCore 메서드를 재정의하고 사용자 지정 구성에 대한 InkDrawingAttributes 를 제공해야 합니다. 이 예제에서는 다음 InkDrawingAttributes를 사용자 지정합니다.
- PenTip은 PenTipShape.Circle으로 설정됩니다.
-
크기 는 의
(strokeWidth, strokeWidth * 20)Windows.Foundation.Size로 설정됩니다. - Color 는 기본적으로 색상표에서 선택한 SolidColorBrush 또는 Colors.Black 으로 설정됩니다.
- PenTipTransform ( Matrix3x2.CreateRotation을 통해)은 펜 팁을 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;
}
}
}
- 태그에서 InkToolbarCustomPenButton 요소의 CustomPen 특성에 있는 {StaticResource} 태그 확장 참조를 사용하여 사용자 지정 펜 클래스를 바인딩합니다(또는 사용자 지정 펜을 인스턴스화하고 코드에서 InkToolbarCustomPenButton.CustomPen에 할당할 수 있음).
기본 제공 InkToolbarPenConfigurationControl을 사용하거나 표준 InkToolbar 펜 선언에서 사용자 지정 InkToolbarPenConfigurationControl 정의를 지정할 수 있습니다.
다음은 이전 코드 조각에 정의된 사용자 지정 펜에 대한 선언입니다.
<!-- 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>
이 예제의 파일에서 의 정의 CalligraphicPenIcon 는 MainPage.xaml.cs 다음과 같습니다.
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();
}
}
}
설명
InkToolbar에서 앱 정의 펜 및 해당 단추를 만들려면 InkToolbarCustomPenButton과 함께 이 클래스를 사용합니다.
생성자
| InkToolbarCustomPen() |
InkToolbarCustomPen 클래스의 새 instance 초기화합니다. |
속성
| Dispatcher |
이 개체가 연결된 CoreDispatcher 를 가져옵니다. CoreDispatcher는 코드가 비 UI 스레드에서 시작되더라도 UI 스레드에서 DependencyObject에 액세스할 수 있는 기능을 나타냅니다. (다음에서 상속됨 DependencyObject) |