IInkDrawingAttributes

. (IInkDrawingAttributes)

この InkDrawingAttributes オブジェクトで描画されるインク (手書き) の色を取得または設定します。(Get)

ハイコントラストモードでは、Color プロパティの設定にかかわらず、インクは常にシステムの色設定 (COLOR_WINDOWTEXT) で表示されます。ただし、インクの実際の色は常に設定された色として保存され、設定されていない場合は既定の色 (BLACK) が保存されます。たとえば、Color プロパティに RED を設定した場合、ハイコントラストモードのユーザーにはシステムの色でインクが表示されますが、ハイコントラストモードではないユーザーには設定された色である RED でインクが描画されて表示されます。この機能により、ハイコントラストモードのユーザーは、実際のストロークの色を変更することなく、システム設定の色でインクを表示できます。

つまり、既定ではハイコントラストモードのときにすべてのインクが 1 つの色にマッピングされます。この既定の色マッピング動作を無効にして独自の動作を実装するには、インクコレクターの SupportHighContrastInk プロパティを使用します。

ハイコントラストモードを実際に有効にするには、インクコレクターの AutoRedraw プロパティを TRUE に設定する必要があります (これは、ウィンドウが無効化されたときにインクが再描画されることを意味します)。AutoRedraw プロパティを FALSE に設定した場合、Tablet PC アプリケーションプログラミングインターフェイス (API) はハイコントラストモードをサポートしません。

この InkDrawingAttributes オブジェクトで描画されるインク (手書き) の色を取得または設定します。(Put)

ハイコントラストモードでは、Color プロパティの設定にかかわらず、インクは常にシステムの色設定 (COLOR_WINDOWTEXT) で表示されます。ただし、インクの実際の色は常に設定された色として保存され、設定されていない場合は既定の色 (BLACK) が保存されます。たとえば、Color プロパティに RED を設定した場合、ハイコントラストモードのユーザーにはシステムの色でインクが表示されますが、ハイコントラストモードではないユーザーには設定された色である RED でインクが描画されて表示されます。この機能により、ハイコントラストモードのユーザーは、実際のストロークの色を変更することなく、システム設定の色でインクを表示できます。

つまり、既定ではハイコントラストモードのときにすべてのインクが 1 つの色にマッピングされます。この既定の色マッピング動作を無効にして独自の動作を実装するには、インクコレクターの SupportHighContrastInk プロパティを使用します。

ハイコントラストモードを実際に有効にするには、インクコレクターの AutoRedraw プロパティを TRUE に設定する必要があります (これは、ウィンドウが無効化されたときにインクが再描画されることを意味します)。AutoRedraw プロパティを FALSE に設定した場合、Tablet PC アプリケーションプログラミングインターフェイス (API) はハイコントラストモードをサポートしません。

インクを描画するときのペン先の y 軸方向のサイズ (幅) を取得または設定します。(Get)

タブレットがペンの筆圧を報告する場合 (IgnorePressure プロパティが false の場合)、インクの実際の幅は描画面に加えられた筆圧の大きさに応じて変化します。最大の筆圧が加えられたときの幅は Width プロパティの値の 150% になり、最小の筆圧のときの幅は Width プロパティの値の 50% になります。既定ではこのプロパティは true に設定されており、ペンからの筆圧が報告されます。筆圧を報告しない (インクの幅が変化しない) ように指定するには、IgnorePressure プロパティを true に設定します。

精度は HIMETRIC 単位の 1000 分の 1 (小数点以下 3 桁) に制限されます。たとえば、2.0006 という値を指定した場合、最も精密な測定値は 2.001 になります。

インクを描画するときのペン先の y 軸方向のサイズ (幅) を取得または設定します。(Put)

タブレットがペンの筆圧を報告する場合 (IgnorePressure プロパティが false の場合)、インクの実際の幅は描画面に加えられた筆圧の大きさに応じて変化します。最大の筆圧が加えられたときの幅は Width プロパティの値の 150% になり、最小の筆圧のときの幅は Width プロパティの値の 50% になります。既定ではこのプロパティは true に設定されており、ペンからの筆圧が報告されます。筆圧を報告しない (インクの幅が変化しない) ように指定するには、IgnorePressure プロパティを true に設定します。

精度は HIMETRIC 単位の 1000 分の 1 (小数点以下 3 桁) に制限されます。たとえば、2.0006 という値を指定した場合、最も精密な測定値は 2.001 になります。

InkDrawingAttributes オブジェクトでインクを描画するときのペンの高さを取得または設定します。(Get)

このプロパティは Rectangle のペン先にのみ適用されます。値は矩形の辺の高さを表します。Ball のペン先を使用している場合、ペン先の高さは Width プロパティと等しくなり、Height プロパティは無視されます。

精度は 1/1000 (小数点以下 3 桁) に制限されます。たとえば、2.0006 という値を指定した場合、最も精密な測定値は 2.001 になります。

InkDrawingAttributes オブジェクトでインクを描画するときのペンの高さを取得または設定します。(Put)

このプロパティは Rectangle のペン先にのみ適用されます。値は矩形の辺の高さを表します。Ball のペン先を使用している場合、ペン先の高さは Width プロパティと等しくなり、Height プロパティは無視されます。

精度は 1/1000 (小数点以下 3 桁) に制限されます。たとえば、2.0006 という値を指定した場合、最も精密な測定値は 2.001 になります。

インクの描画にベジエスムージングを使用するかどうかを指定する値を取得または設定します。(Get)

ベジエスムージングでは、インクをペンのサンプル点間を結ぶ直線ではなく、一連の曲線として描画します。インクを一連の曲線として描画すると、特に書き手の筆跡が安定していない場合に、インクを滑らかにするのに役立ちます。

ストロークの収集中にこのプロパティを設定した場合、インクは再描画または更新されるまで一連の曲線として描画されません。

インクの描画にベジエスムージングを使用するかどうかを指定する値を取得または設定します。(Put)

ベジエスムージングでは、インクをペンのサンプル点間を結ぶ直線ではなく、一連の曲線として描画します。インクを一連の曲線として描画すると、特に書き手の筆跡が安定していない場合に、インクを滑らかにするのに役立ちます。

ストロークの収集中にこのプロパティを設定した場合、インクは再描画または更新されるまで一連の曲線として描画されません。

タブレット面へのペン先の筆圧が強くなるにつれて、描画されるインクが自動的に太くなるかどうかを指定する値を取得または設定します。(Get)

ペン先への筆圧が強いほど、多くのインクが描画されます。この効果を発生させたくない場合は、このプロパティに VARIANT_TRUE を設定します。

タブレット面へのペン先の筆圧が強くなるにつれて、描画されるインクが自動的に太くなるかどうかを指定する値を取得または設定します。(Put)

ペン先への筆圧が強いほど、多くのインクが描画されます。この効果を発生させたくない場合は、このプロパティに VARIANT_TRUE を設定します。

ストロークをアンチエイリアス処理するかどうかを示す値を取得または設定します。(Get)

ストロークがアンチエイリアス処理されると、インクの縁に沿って前景色と背景色が混合され、見た目の滑らかさが向上します。

アンチエイリアス処理は、特に解像度の低いディスプレイでインクをより滑らかで鮮明に見せ、描画の品質を向上させます。ただし、アンチエイリアス処理には追加の処理負荷が伴うため、適切に判断して使用してください。

ストロークをアンチエイリアス処理するかどうかを示す値を取得または設定します。(Put)

ストロークがアンチエイリアス処理されると、インクの縁に沿って前景色と背景色が混合され、見た目の滑らかさが向上します。

アンチエイリアス処理は、特に解像度の低いディスプレイでインクをより滑らかで鮮明に見せ、描画の品質を向上させます。ただし、アンチエイリアス処理には追加の処理負荷が伴うため、適切に判断して使用してください。

インクの透明度を示す値を取得または設定します。(Get)

インクの透明度を示す値を取得または設定します。(Put)

ペンと背景の色がどのように相互作用するかを定義する値を取得または設定します。(Get)

InkRasterOperation 列挙体は、描画されたインクに対してラスター操作を実行するための値を定義します。たとえば、減算による透明化を行う場合は、ラスター値に MaskPen を設定します。

使用可能なラスター操作の完全な一覧については、InkRasterOperation 列挙型を参照してください。

ペンと背景の色がどのように相互作用するかを定義する値を取得または設定します。(Put)

InkRasterOperation 列挙体は、描画されたインクに対してラスター操作を実行するための値を定義します。たとえば、減算による透明化を行う場合は、ラスター値に MaskPen を設定します。

使用可能なラスター操作の完全な一覧については、InkRasterOperation 列挙型を参照してください。

この InkDrawingAttributes オブジェクトに関連付けられたインクを描画するときに、どのペン先を使用するかを示す値を取得または設定します。(Get)

使用可能なペン先の完全な一覧については、InkPenTip 列挙体を参照してください。

このプロパティに InkPenTip.IPT_Ball を設定した場合、Height プロパティは無視されます。

正方形のペン先を作成するには、PenTip プロパティに InkPenTip.IPT_Rectangle を設定します。次に、Height プロパティを Width プロパティと同じ値に設定します。

この InkDrawingAttributes オブジェクトに関連付けられたインクを描画するときに、どのペン先を使用するかを示す値を取得または設定します。(Put)

使用可能なペン先の完全な一覧については、InkPenTip 列挙体を参照してください。

このプロパティに InkPenTip.IPT_Ball を設定した場合、Height プロパティは無視されます。

正方形のペン先を作成するには、PenTip プロパティに InkPenTip.IPT_Rectangle を設定します。次に、Height プロパティを Width プロパティと同じ値に設定します。

オブジェクトに格納されているアプリケーション定義データのコレクションを取得します。(IInkDrawingAttributes.get_ExtendedProperties)

アプリケーションは ExtendedProperties プロパティを使用して、オブジェクトに格納されているカスタムデータにアクセスできます。このカスタムデータは、オブジェクトとともに自動的にシリアル化されます。

InkDrawingAttributes オブジェクトの複製を作成します。

このメソッドは、次のいずれかの値を返すことがあります。

Clone メソッドは、InkDisp、InkDrawingAttributes、InkRecognizerContext の各オブジェクトに対して定義されています。Clone メソッドは、元のオブジェクトの完全なコピーを返します。

ほとんどの場合、複製されたオブジェクトは元のオブジェクトの完全なコピーですが、2 つのオブジェクトの間に関連は存在しません。これに対する例外の詳細については、このトピックの解説セクションを参照してください。

InkDrawingAttributes オブジェクト: 通常は、描画属性のマスターコピーを複製し、1 つ以上の属性を変更したうえで、ModifyDrawingAttributes メソッドを呼び出して、変更した描画属性を使用します。