InkCollectorCursorInRangeEventHandler デリゲート
InkCollector オブジェクトの CursorInRange イベントを処理するメソッドを表します。
名前空間 : Microsoft.Ink
アセンブリ : Microsoft.Ink (Microsoft.Ink.dll 内)
構文
'宣言
Public Delegate Sub InkCollectorCursorInRangeEventHandler ( _
sender As Object, _
e As InkCollectorCursorInRangeEventArgs _
)
'使用
Dim instance As New InkCollectorCursorInRangeEventHandler(AddressOf HandlerMethod)
public delegate void InkCollectorCursorInRangeEventHandler(
Object sender,
InkCollectorCursorInRangeEventArgs e
)
public delegate void InkCollectorCursorInRangeEventHandler(
Object^ sender,
InkCollectorCursorInRangeEventArgs^ e
)
/** @delegate */
public delegate void InkCollectorCursorInRangeEventHandler(
Object sender,
InkCollectorCursorInRangeEventArgs e
)
JScript では、デリゲートは使用できません。
パラメータ
- sender
型 : System.Object
このイベントのソース InkCollector オブジェクト。
- e
型 : Microsoft.Ink.InkCollectorCursorInRangeEventArgs
イベント データを格納している InkCollectorCursorInRangeEventArgs オブジェクト。
解説
InkCollectorCursorInRangeEventHandler デリゲートを作成する場合は、イベントを処理するメソッドを指定します。イベントをイベント ハンドラに関連付けるには、デリゲートのインスタンスをイベントに追加します。デリゲートを削除しない限り、そのイベントが発生すると常にイベント ハンドラが呼び出されます。既定のイベント対象は有効です。
CursorInRange イベントは、インク モードのみでなく選択モードや消去モードの場合でも発生します。このためには編集モードを監視し (設定する必要があります)、イベントを解釈する前にモードを認識する必要があります。この要件の利点は、プラットフォーム イベントの認識がより容易になることにより、プラットフォーム上での新しい技術の導入がより可能になることです。
例
この例では、CursorInRange イベントが発生するときに、InkCollector オブジェクトがこの特定の Cursor オブジェクトとやり取りを行ったのがこれが初めてであるかどうかを確認するチェックが行われます。初めてである場合は、DefaultDrawingAttributes プロパティの複製を使用して、DrawingAttributes プロパティが割り当てられます。これにより、以降の DrawingAttributes プロパティへのアクセスで、Null 参照例外がスローされなくなります。
Private Sub mInkObject_CursorInRange(ByVal sender As Object, ByVal e As InkCollectorCursorInRangeEventArgs)
Const MOUSE_CURSOR_ID As Integer = 1
If e.NewCursor Then
' mInkObject can be InkCollector, InkOverlay, or InkPicture
e.Cursor.DrawingAttributes = mInkObject.DefaultDrawingAttributes.Clone()
' if this cursor is the mouse, we'll set color to red
If (MOUSE_CURSOR_ID = e.Cursor.Id) Then
e.Cursor.DrawingAttributes.Color = Color.Red
End If
End If
End Sub
private void mInkObject_CursorInRange(object sender, InkCollectorCursorInRangeEventArgs e)
{
const int MOUSE_CURSOR_ID = 1;
if (e.NewCursor)
{
// mInkObject can be InkCollector, InkOverlay, or InkPicture
e.Cursor.DrawingAttributes = mInkObject.DefaultDrawingAttributes.Clone();
// if this cursor is the mouse, we'll set color to red
if (MOUSE_CURSOR_ID == e.Cursor.Id)
{
e.Cursor.DrawingAttributes.Color = Color.Red;
}
}
}
プラットフォーム
Windows Vista
.NET Framework および .NET Compact Framework では、各プラットフォームのすべてのバージョンはサポートしていません。サポートされているバージョンについては、「.NET Framework システム要件」を参照してください。
バージョン情報
.NET Framework
サポート対象 : 3.0