Windows.UI.Input.Inking 名前空間
重要
一部の情報は、リリース前に大きく変更される可能性があるプレリリースされた製品に関するものです。 Microsoft は、ここに記載されている情報について、明示または黙示を問わず、一切保証しません。
Windows Ink アプリの入力、処理、管理のサポートを提供します。 これには次のものが含まれます
- インク ストロークの描画。
- ストロークのキャプチャ。
- レンダリング ストローク。
- ストロークの選択。
- ストロークを削除しています。
- ストロークの保存と読み込み。
- 手書き認識を使用してストロークをテキストに変換する。
- クリップボードからのストロークのコピーと貼り付け。
- ヒット テスト (またはストローク ターゲット)。
クラス
| InkDrawingAttributes |
InkStroke の描画に関連付けられたプロパティを提供します。 |
| InkDrawingAttributesPencilProperties |
InkCanvas で鉛筆ストロークをレンダリングするための一連の静的 InkDrawingAttributes プロパティを提供します。 InkDrawingAttributes.CreateForPencil を呼び出し、InkDrawingAttributes.PencilProperties にアクセスして、このクラスのインスタンスを取得します。 |
| InkInputConfiguration |
InkPresenter オブジェクトで処理できるセカンダリ入力の種類を管理します。 |
| InkInputProcessingConfiguration |
InkPresenter オブジェクトによる入力の処理方法を管理します。 |
| InkManager |
Note Extensible Application Markup Language (XAML) を使用するユニバーサル Windows アプリの場合は、InkManager の代わりに InkPresenter と InkCanvas コントロールを使用することをお勧めします。 1 つ以上の InkStroke オブジェクトの入力、操作、および処理 (手書き認識を含む) を管理します。 |
| InkModelerAttributes |
InkPresenter オブジェクトで処理できるインク モデラー属性の種類を管理します。 |
| InkPoint |
InkStroke の構築で使用される 1 つのポイントの生の入力データを提供します。 |
| InkPresenter |
InkCanvas コントロールのインク入力 (標準および変更済み) の入力、処理、レンダリングを管理するためのプロパティ、メソッド、およびイベントを提供します。 |
| InkPresenterProtractor |
InkCanvas に半透明のオーバーレイとして表示される、円弧と曲線を描画するための分度器の形式でビジュアル ステンシルを表します。 ステンシルは、インク ストロークのレンダリング方法を変換します。
InkPresenterRuler は、プログラムとユーザーの両方で操作できます。 また、 InkCanvas を使用してスケーリングと翻訳も行います。 |
| InkPresenterRuler |
InkCanvas に半透明のオーバーレイとして表示される、直線を描画するための直線のルールの形式でビジュアル ステンシルを表します。 ステンシルは、インク ストロークのレンダリング方法を変換します。
InkPresenterRuler は、プログラムとユーザーの両方で操作できます。 また、 InkCanvas を使用してスケーリングと翻訳も行います。 |
| InkRecognitionResult |
InkStroke の手書き認識データを管理するためのプロパティとメソッドを提供します。 認識結果は、 InkRecognizer によって検出された単語ごとに生成されます。 |
| InkRecognizer |
手書き認識のすべての側面を管理します。 |
| InkRecognizerContainer |
手書き認識に使用される 1 つ以上 の InkRecognizer オブジェクトを管理するためのプロパティとメソッドを提供します。 認識エンジンがシステムで使用できない場合、InkRecognizerContainer は null です。 |
| InkStroke |
ストロークの最終レンダリングに使用されるベジエ曲線パラメーターを含む、1 つのインク ストローク。 |
| InkStrokeBuilder |
生ポインター入力からストロークを作成します。 注意 Extensible Application Markup Language (XAML) を使用するユニバーサル Windows アプリの場合は、InkManager の代わりに InkPresenter と InkCanvas コントロールを使用することをお勧めします。 CreateStrokeFromInkPoints と SetDefaultDrawingAttributes を使用して、InkPresenter のストロークをプログラムで作成します。 |
| InkStrokeContainer |
InkPresenter によってレンダリングされる InkStroke オブジェクトのコレクションを格納および管理するためのプロパティとメソッドを提供します。 ストローク コンテナー内のいずれかのインク ストロークに対して行われた変更は、 InkPresenter に関連付けられている描画サーフェイスにすぐにレンダリングされます。 |
| InkStrokeInput |
InkPresenter オブジェクトに関連付けられた StrokeInput のプロパティとイベントを提供します。 |
| InkStrokeRenderingSegment |
完全なインク ストロークの 1 つのセグメント。 1 つのセグメントは、開始点、終了点、および 2 つのベジエコントロールポイントで構成されます。 ただし、ストロークを構成する一連のセグメントでは、前のセグメントの最後のポイントが現在のセグメントの最初のポイントになります。 つまり、完全なストロークを表すには、各セグメントの終了点のみが必要です。 各ストロークは InkStrokeRenderingSegment オブジェクトのベクトルであり、最初のセグメントは 1 つの開始点で識別され、残りのすべてのセグメントは終了点と 2 つのベジエコントロールポイントで識別されます。 |
| InkStrokesCollectedEventArgs |
InkCanvas コントロールに関連付けられた InkPresenter の StrokesCollected イベントのイベント データを格納します。 既定では、インク ストロークは待機時間の短いバックグラウンド スレッドで処理され、描画時に濡れてレンダリングされます。 ストロークが完了すると (ペンまたは指が持ち上げられたり、マウス ボタンが離されたり)、ストロークが UI スレッドで処理され、 InkCanvas レイヤー (アプリケーション コンテンツの上) に乾燥してレンダリングされます。 UI スレッドがビジー状態の場合、スレッドが使用可能になったときに、複数のインク ストロークが処理 (収集) される可能性があります。 この動作は、InkCanvas を読み込む前に ActivateCustomDrying メソッドを呼び出すことによってオーバーライドできます。 |
| InkStrokesErasedEventArgs |
InkCanvas コントロールに関連付けられた InkPresenter の StrokesErased イベントのイベント データを格納します。 既定では、インク ストローク データとレンダリングは InkCanvas コントロールによって完全に管理されます。 ただし、InkCanvas を読み込む前に ActivateCustomDrying メソッドを呼び出すことで、この動作をオーバーライドできます。 |
| InkSynchronizer |
インク入力の同期を管理し、既定の InkCanvas コントロールではなく、ユニバーサル Windows アプリの Direct2D デバイス コンテキストにレンダリングするためのメソッドを提供します。 これには、インク入力を管理するために IInkD2DRenderer オブジェクトが必要です ( 「複雑なインクサンプル」を参照してください)。 既定では、手書き入力は低待機時間のバックグラウンド スレッドで処理され、描画と同時に "ウェット" レンダリングが行われます。 ストロークが完了すると (ペンまたは指が画面を離れるか、マウスのボタンが離されると)、UI スレッドでストロークが処理されて、InkCanvas レイヤーへの "ドライ" レンダリングが行われます (アプリケーション コンテンツの上にレンダリングされてウェット インクが置き換えられます)。 ActivateCustomDrying を (InkCanvas が読み込まれる前に) 呼び出すと、SurfaceImageSource または VirtualSurfaceImageSource へのインク ストロークのドライ レンダリングの方法をカスタマイズするための InkSynchronizer オブジェクトが作成されます。 たとえば、インク ストロークをラスタライズしてアプリケーション コンテンツに (別の InkCanvas レイヤーとしてではなく) 統合することができます。 |
| InkUnprocessedInput |
InkCanvas コントロールからインク データをカスタム処理するためのプロパティとイベントを提供します。 データは InkPresenter によって処理されません。 InkInputProcessingConfiguration を使用して、UnprocessedInput として渡すデータを識別します。 |
| PenAndInkSettings |
テキスト コントロールでのインクの受け入れとテキスト入力への変換に関連するユーザー設定へのアクセスを提供します ( HandwritingView が有効になっている場合)。 |
インターフェイス
| IInkPointFactory | |
| IInkPresenterRulerFactory |
InkPresenter の構築に使用される InkPresenterRuler オブジェクトを生成する型の実装を定義します。 |
| IInkPresenterStencil |
InkCanvas に半透明のオーバーレイとして表示されるビジュアル ステンシルを表します。 ステンシルは、インク ストロークのレンダリング方法を変換します。
ステンシルは、プログラムとユーザーの両方で操作できます。 また、 InkCanvas を使用してスケーリングと翻訳も行います。 |
| IInkRecognizerContainer |
1 つ以上の InkRecognizer オブジェクトを 表します。 |
| IInkStrokeContainer |
InkPresenter によってレンダリングされる InkStroke オブジェクトのコレクションのマネージャーを表します。 ストローク コンテナー内のいずれかのインク ストロークに対して行われた変更は、 InkPresenter に関連付けられている描画サーフェイスにすぐにレンダリングされます。 |
列挙型
| HandwritingLineHeight |
テキスト コントロールでテキスト入力にインクを使用するときに使用できる手書き領域を指定します ( HandwritingView が有効になっている場合)。 |
| InkDrawingAttributesKind |
InkStroke に関連付けられている InkDrawingAttributes の種類を指定します。 |
| InkHighContrastAdjustment |
システムがハイ コントラスト モードのときに、関連する InkCanvas コントロールからの入力 (標準および変更済み) を InkPresenter オブジェクトが処理する方法を指定します。 |
| InkInputProcessingMode |
InkPresenter オブジェクトが、関連付けられている InkCanvas コントロールからの入力を解釈する方法を指定します。 既定では、入力は標準のインクまたは消去ストロークとして処理されます。または、カスタム処理のために UnprocessedInput としてアプリに渡すことができます。 |
| InkInputRightDragAction |
InkPresenter オブジェクトがペンバレル ボタン、ペン消しゴムの先端、マウスの右ボタンなどのセカンダリ入力を処理する方法を指定します。 既定では、このセカンダリ入力はプライマリ入力として処理され、 InkStroke としてレンダリングされます (解説を参照)。 |
| InkManipulationMode |
インク入力のモードを指定します。 |
| InkPersistenceFormat |
インク入力を保存する形式を指定します。 |
| InkPresenterPredefinedConfiguration |
1 つ以上の接触点の手描き入力動作を指定します。 SetPredefinedConfiguration と共に使用されます。 |
| InkPresenterStencilKind |
InkCanvas に表示できるステンシルの種類を指定します。 |
| InkRecognitionTarget |
手書き認識に含めるストロークを示します。 |
| PenHandedness |
[設定] - [デバイス] - [ペン] & Windows Ink> ->> 書き込み先の手を選択する] でユーザーが指定した、優先する手書き手を識別します。 |
| PenTipShape |
ペンヒントの図形を識別します。 |
こちらもご覧ください
- ペン操作とスタイラス操作
- 作業の開始: UWP アプリでのインクのサポート
- インクの分析のサンプル (基本) (C#)
- インクの手書き認識のサンプル (C#)
- インク ストロークを Ink Serialized Format (ISF) ファイルに保存し、読み込む
- インク ストロークをクリップボードに保存し、読み込む
- インク ツール バーの位置と向きのサンプル (基本)
- インク ツール バーの位置と向きのサンプル (動的)
- 塗り絵帳のサンプル
- Family Notes のサンプル
- 手描き入力のサンプル (JavaScript)
- 単純な手描き入力のサンプル (C#/C++)
- 複雑な手描き入力のサンプル (C++)
- インク分析のサンプル
フィードバック
以下は間もなく提供いたします。2024 年を通じて、コンテンツのフィードバック メカニズムとして GitHub の issue を段階的に廃止し、新しいフィードバック システムに置き換えます。 詳細については、「https://aka.ms/ContentUserFeedback」を参照してください。
フィードバックの送信と表示