InkOverlay クラス

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

透明なコントロールの背後に 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 オブジェクトは、メモの作成と基本的な落書きに適しています。 このオブジェクトの主な用途は、インクをインクとして表示することです。

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

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

注意事項

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

Note

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

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

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);
}

要件

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

関連項目

InkCollector クラス

InkPicture コントロール リファレンス

InkEdit コントロール リファレンス