InkOverlay クラス

[アーティクル]
06/13/2023

ユーザーがインクに対する認識の実行に関心を持たず、代わりにインクのサイズ、形状、色、位置に関心がある注釈シナリオに役立つオブジェクトを表します。

透明なコントロールの背後に InkOverlay コントロールを作成すると (WS_EX_TRANSPARENT プロパティセットを持つ GroupBox など) 、InkOverlay がインクを収集できなくなります。

InkOverlay には、次の種類のメンバーがあります。

イベント
インターフェイス
メソッド
プロパティ

イベント

InkOverlay クラスには、これらのイベントがあります。

Event	説明
CursorButtonDown	InkOverlay が下にあるカーソルボタンを検出したときに発生します。
CursorButtonUp	InkOverlay が、稼働中のカーソルボタンを検出したときに発生します。
CursorDown	カーソルの先端がデジタイズタブレットの表面に接触したときに発生します。
CursorInRange	カーソルがタブレットコンテキストの物理的な検出範囲 (近接) に入ったときに発生します。
CursorOutOfRange	カーソルがタブレットコンテキストの物理的な検出範囲 (近接) から離れると発生します。
Doubleclick	InkOverlay オブジェクトがダブルクリックされたときに発生します。
ジェスチャ	アプリケーション固有のジェスチャが認識されたときに発生します。
MouseDown	マウスポインターが InkOverlay オブジェクトの上にあり、マウスボタンが押されたときに発生します。
MouseMove	マウスポインターが InkOverlay オブジェクトの上に移動したときに発生します。
MouseUp	マウスポインターが InkOverlay オブジェクトの上にあり、マウスボタンが離されたときに発生します。
Mousewheel	InkOverlay オブジェクトにフォーカスがあるときにマウスホイールが移動したときに発生します。
NewInAirPackets	ユーザーがタブレットの近くにペンを移動し、カーソルが InkOverlay オブジェクトのウィンドウ内にあるか、ユーザーが InkOverlay オブジェクトの関連付けられたウィンドウ内でマウスを移動したときに発生する、空中パケットが表示されたときに発生します。
NewPackets	InkOverlay オブジェクトがパケットを受信したときに発生します。
塗装	InkOverlay オブジェクト自体の再描画が完了したときに発生します。
描画	InkOverlay オブジェクトが再描画される前に発生します。
SelectionChanged	ユーザーインターフェイスの変更、切り取りおよび貼り付けプロシージャ、 Selection プロパティなど、コントロール内のインクの選択が変更されたときに発生します。
SelectionChanging	ユーザーインターフェイスの変更、切り取りおよび貼り付けプロシージャ、 Selection プロパティなど、コントロール内のインクの選択が変更されようとしているときに発生します。
SelectionMoved	ユーザーインターフェイスの変更、切り取りおよび貼り付けプロシージャ、 Selection プロパティなど、現在の選択範囲の位置が変更されたときに発生します。
SelectionMoving	ユーザーインターフェイスの変更、切り取りおよび貼り付けプロシージャ、 Selection プロパティなど、現在の選択範囲の位置が変更されようとしているときに発生します。
SelectionResized	ユーザーインターフェイスの変更、切り取りおよび貼り付けプロシージャ、 Selection プロパティなど、現在の選択範囲のサイズが変更されたときに発生します。
SelectionResizing	ユーザーインターフェイスの変更、切り取りおよび貼り付けプロシージャ、 Selection プロパティなど、現在の選択範囲のサイズが変更されようとしているときに発生します。
ストローク	ユーザーが任意のタブレットで新しいストロークの描画を完了したときに発生します。
StrokesDeleted	Ink プロパティからストロークが削除された後に発生します。
StrokesDeleting	Ink プロパティからストロークが削除される前に発生します。
SystemGesture	システムジェスチャが認識されたときに発生します。
TabletAdded	IInkTablet がシステムに追加されたときに発生します。
TabletRemoved	タブレットがシステムから削除されたときに発生します。

インターフェイス

InkOverlay クラスは、これらのインターフェイスを定義します。

インターフェイス	説明
IInkOverlay	このオブジェクトは、 IInkOverlay COM インターフェイスを実装します。

メソッド

InkOverlay クラスには、これらのメソッドがあります。

メソッド	説明
描画	InkOverlay オブジェクト内でインクを再描画する四角形を設定します。
GetEventInterest	特定の InkOverlay オブジェクトイベントの現在の状態 (イベントがリッスンされているか使用されているか) を返します。
GetGestureStatus	InkOverlay オブジェクトが特定のジェスチャに関心があるかどうかを返します。
GetWindowInputRectangle	インクを描画するウィンドウの四角形をピクセル単位で取得します。
HitTestSelection	ヒットテスト中にヒットした選択範囲の部分を決定します。
SetAllTabletsMode	このモードを使用すると、 InkOverlay オブジェクトは、タブレット PC に接続されている任意のタブレットからインクを収集できます。
SetEventInterest	特定のイベントをリッスンするか使用するかを設定します。
SetGestureStatus	既知のジェスチャで InkOverlay オブジェクトの関心を設定します。
SetSingleTabletIntegratedMode	このモードでは、 InkOverlay オブジェクトが 1 つのタブレットからのみインクを収集できます。 InkOverlay オブジェクトでは、他のタブレットのインクは無視されます。
SetWindowInputRectangle	描画されたインクをウィンドウにマップするために使用するウィンドウの四角形をピクセル単位で設定します。

プロパティ

InkOverlay クラスには、これらのプロパティがあります。

プロパティ	アクセスの種類	説明
AttachMode	読み取り/書き込み	InkOverlay オブジェクトを既知のウィンドウの背後または前面にアタッチするかどうかを指定する値を取得または設定します。
AutoRedraw	読み取り/書き込み	ウィンドウが無効になったときに InkOverlay がインクを再描画するかどうかを指定する値を取得または設定します。
CollectingInk	読み取り専用	InkOverlay オブジェクトにインクが現在描画されているかどうかを示す値を取得します。
CollectionMode	読み取り/書き込み	インク、ジェスチャ、またはその両方がユーザーの書き込みとして認識されるかどうかを決定するコレクションモードを取得または設定します。
カーソル	読み取り専用	インク領域で使用できる Cursors コレクションを取得します。
DefaultDrawingAttributes	読み取り/書き込み	インクの描画および表示時に使用される描画属性を指定する、既定の InkDrawingAttributes オブジェクトを取得または設定します。
DesiredPacketDescription	読み取り/書き込み	InkOverlay オブジェクトに描画されたインクに関連付けられているパケットの側面を取得または設定します。
DynamicRendering	読み取り/書き込み	インクが描画されるときにレンダリングされるかどうかを示す値を取得または設定します。
EditingMode	読み取り/書き込み	InkOverlay がインクモード、削除モード、または選択/編集モードかどうかを示す値を取得または設定します。
Enabled	読み取り/書き込み	InkOverlay オブジェクトがペン入力を収集するかどうかを指定する値を取得または設定します。
消しゴムモード	読み取り/書き込み	ストロークまたはポイントによってインクが消去されるかどうかを示す値を取得または設定します。
EraserWidth	読み取り/書き込み	消しゴムのペン先の幅を指定する値を取得または設定します。
Handle	読み取り/書き込み	InkOverlay オブジェクトがアタッチされているウィンドウのハンドルを取得または設定します。
インク	読み取り/書き込み	InkOverlay オブジェクトに関連付けられている InkDisp オブジェクトを取得または設定します。
MarginX	読み取り/書き込み	x 軸に沿った余白をピクセル単位で取得または設定します。
MarginY	読み取り/書き込み	y 軸に沿った余白をピクセル単位で取得または設定します。
MouseIcon	読み取り/書き込み	現在のカスタムマウスアイコンを取得または設定します。
MousePointer	読み取り/書き込み	オブジェクトの特定の部分にマウスを置いたときに表示されるマウスポインターの種類を示す値を取得または設定します。
レンダラー	読み取り/書き込み	インクの描画に使用される InkRenderer オブジェクトを取得または設定します。
選択	読み取り/書き込み	InkOverlay コントロール内で現在選択されている InkStrokes コレクションを取得または設定します。
SupportHighContrastInk	読み取り/書き込み	システムがハイコントラストモードのときにインクを 1 色としてレンダリングするかどうかを指定する値を取得または設定します。
SupportHighContrastSelectionUI	読み取り/書き込み	システムがハイコントラストモードのときに、すべての選択 UI をハイコントラストで描画するかどうかを指定する値を取得または設定します。
タブレット	読み取り専用	InkOverlay オブジェクトが入力の収集に現在使用しているタブレットデバイスを取得します。

MFC 実装に関する注意事項

InkOverlay オブジェクトを CView オブジェクトにアタッチした場合は、次の例に示すように、WM_DESTROY メッセージに応答して InkOverlay オブジェクトを解放します。

BOOL CRecognitionAlternatesSampleCppView::OnWndMsg(UINT msg, WPARAM wp, PARAM lp, LRESULT *pLR)
{
    if(WM_DESTROY == msg)
        m_spInkOverlay.Release();
    return CView::OnWndMsg(msg, wp, lp, pLR);
}

解説

このオブジェクトは、C++ で CoCreateInstance メソッドを呼び出すことによってインスタンス化できます。

InkOverlay オブジェクトは、メモの作成と基本的な落書きに適しています。このオブジェクトの主な用途は、インクをインクとして表示することです。

一般に、このオブジェクトの実行時ユーザーインターフェイスは、不透明なインクを持つ透明ウィンドウです。

MouseDown、MouseMove、MouseUp、および MouseWheel イベントは、インク空間に関連付けられている HIMETRIC 単位ではなく、x 座標と y 座標をピクセル単位で返します。これは、これらのイベントがペン非対応アプリケーションのマウスイベントを置き換え、これらのアプリケーションがピクセルのみを認識するためです。

注意事項

InkOverlay オブジェクトの AttachMode プロパティを InFront に設定する場合は、フォームが実行されているスレッドに InkOverlay オブジェクトを作成します。 InkOverlay オブジェクトが別のスレッドで作成され、その AttachMode プロパティが InFront に設定されている場合、アプリケーションは応答を停止することがあります。

Note

InkOverlay オブジェクトを UI 以外のスレッドで安全に解放することはできません。

アプリケーションのパフォーマンスを向上させるには、 InkOverlay オブジェクトが不要になったら破棄します。

BOOL CRecognitionAlternatesSampleCppView::OnWndMsg(UINT msg, WPARAM wp, PARAM lp, LRESULT *pLR)
{
    if(WM_DESTROY == msg)
        m_spInkOverlay.Release();
    return CView::OnWndMsg(msg, wp, lp, pLR);
}

要件

要件	値
サポートされている最小のクライアント	Windows XP Tablet PC Edition [デスクトップアプリのみ]
サポートされている最小のサーバー	サポートなし
ヘッダー	Msinkaut.h (Msinkaut_i.c も必要)
ライブラリ	InkObj.dll