このコントーロールは、現在、開発者のプレビューとして入手できます。私たちは、現在、あなた独自のプロトタイプ・コードで、このコントロールを試していることをお勧めしますが、私たちは、あなたが、この時点の製作コードで、それを使用することをお勧めしません。このコントロールは、今後のツールキット・リリースで成熟し安定し続けるでしょう。あなたが、このコントロールについて意見をもっている場合、Microsoft.Toolkit.Win32リポジトリに新しい問題を作成します。そして、そこに、あなたのコメントを残します。あなたが、個人的にフィードバックを送信することを望む場合、あなたは、それを、XamlIslandsFeedback@microsoft.comに送信することができます。あなたの洞察とシナリオは、私たちにとってきわめて重要です。
InkCanvasコントロールは、Windowsのインクベースのユーザー操作のためのサーフェスを提供します。あなたのWindows FormやWPFデスクトップ・アプリケーションで、このコントロールは、インク・ストロークや消去ストロークのどちらかとして、すべてのペン入力を受け取って、表示するパネルを埋めます。これは、ラップされたUniversal Windows Platformコントロールの1つです。Windows FormとWPFアプリケーションが、それを利用できます。詳細については、デスクトップ・アプリケーションのUWPコントロールを参照してください。
InkCanvasコントロールについて
About InkCanvas control
このコントロールのWPFのバージョンは、Microsoft.Toolkit.Wpf.UI.Controls名前空間に配置されます。Windows Formのバージョンは、Microsoft.Toolkit.Forms.UI.Controls名前空間に配置されます。Microsoft.Toolkit.Win32.UI.Controls.Interop.WinRT名前空間で、あなたは、(列挙型とイベント引数クラスのような)追加の関連づけられた型を見つけることができます。
このコントロールは、UWP Windows.UI.Xaml.Controls.InkCanvasコントロールのインスタンスをラップします。
既知の問題と制限
Known issues and limitations
対話モードが、設定されているInkToolbarが、関連付けられていない、UWPのWindows.UI.Xaml.Controls.InkCanvasコントロールのように、このコントロールは、対話処理を提供しません。あなたは、Windows 10のダーク・テーマを使用するデバイス上で、実行中の間、適切にインクが、表示しないかもしれないことに気づくでしょう。
Windows Community ToolkitリポジトリのWPF、および、Windows Formsコントロールに関する既知の問題の一覧もご覧ください。
構文
Syntax
<Window x:Class="TestSample.MainWindow" ...
xmlns:controls="clr-namespace:Microsoft.Toolkit.Wpf.UI.Controls;assembly=Microsoft.Toolkit.Wpf.UI.Controls"
...>
<controls:InkCanvas x:Name="inkCanvas" DockPanel.Dock="Top" Loaded="inkCanvas_Loaded"/>
プロパティ
Properties
プロパティ | 型 | 解説 |
---|---|---|
InkPresenter | InkPresenter | ラップされたUWP Windows.UI.Xaml.Controls.InkToolbarオブジェクトのInkPresenterプロパティをラップします。 |
要件
Requirements
デバイス・ファミリ | NET 4.6.2、Windows 10(v10.0.17709.0を導入) |
---|---|
名前空間 | Windows Forms: Microsoft.Toolkit.Forms.UI.Controls WPF: Microsoft.Toolkit.Wpf.UI.Controls |
Nugetパッケージ | Windows Forms: Microsoft.Toolkit.Forms.UI.Controls |