InkPicture.Stroke イベント

  • [アーティクル]

ユーザーが任意のタブレットに新しいストロークを描画するときに発生します。

構文

void Stroke(
  [in]      IInkCursor     *Cursor,
  [in]      IInkStrokeDisp *Stroke,
  [in, out] VARIANT_BOOL   *Cancel
);

パラメーター

Cursor [in]

Stroke イベントを生成した IInkCursor オブジェクト。

Stroke [in]

収集された IInkStrokeDisp オブジェクト。

Cancel [in, out]

ストロークのコレクションを取り消すVARIANT_TRUE。それ以外の場合は、VARIANT_FALSE。

戻り値

このイベントは値を返しません。

解説

このイベント メソッドは、id が DISPID_ICEStroke のディスパッチ専用インターフェイス (ディスパッチ インターフェイス) _IInkCollectorEvents、_IInkOverlayEvents、および_IInkPictureEventsで定義されます。

Stroke イベントは、インクの挿入時だけでなく、選択モードまたは消去モードの場合に発生します。 そのためには、編集モード (設定を担当する) を監視し、イベントを解釈する前にモードを認識する必要があります。 この要件の利点は、プラットフォーム イベントの認識を高めることによって、プラットフォームでイノベーションを行う自由が高まる点です。

Note

Stroke イベントは、InkStrokes コレクションにストロークが追加されたときではなく、ユーザーがストロークの描画を完了したときに発生します。 ユーザーが最初にストロークの描画を開始すると、InkStrokes コレクションにすぐに追加されます。ただし、 Stroke イベントはストロークが完了するまで発生しません。 そのため、Stroke イベント ハンドラーに表示されていない InkStrokes コレクションに ストローク が存在する可能性があります。

要件

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

関連項目

Inkpicture

StrokesAdded イベント [InkPicture コントロール]

StrokesDeleted イベント [InkPicture コントロール]

IInkCursor インターフェイス

IInkStrokeDisp インターフェイス