InkCollectorCursorButtonUpEventHandler デリゲート

[アーティクル]
10/28/2008

InkCollector オブジェクトの CursorButtonUp イベントを処理するメソッドを表します。

名前空間 : Microsoft.Ink
アセンブリ : Microsoft.Ink (Microsoft.Ink.dll 内)

構文

'宣言
Public Delegate Sub InkCollectorCursorButtonUpEventHandler ( _
    sender As Object, _
    e As InkCollectorCursorButtonUpEventArgs _
)
'使用
Dim instance As New InkCollectorCursorButtonUpEventHandler(AddressOf HandlerMethod)

public delegate void InkCollectorCursorButtonUpEventHandler(
    Object sender,
    InkCollectorCursorButtonUpEventArgs e
)

public delegate void InkCollectorCursorButtonUpEventHandler(
    Object^ sender, 
    InkCollectorCursorButtonUpEventArgs^ e
)

/** @delegate */
public delegate void InkCollectorCursorButtonUpEventHandler(
    Object sender,
    InkCollectorCursorButtonUpEventArgs e
)

JScript では、デリゲートは使用できません。

パラメータ

sender
型 : System.Object
このイベントのソース InkCollector オブジェクト。

e
型 : Microsoft.Ink.InkCollectorCursorButtonUpEventArgs
イベントデータを格納している InkCollectorCursorButtonUpEventArgs オブジェクト。

解説

ユーザーがストロークを完了し、デジタイザからペンを上げたときに、ペンチップのボタンは上がります。ボタンが押されていないと、胴体のボタンは上がります。

InkCollectorCursorButtonUpEventHandler デリゲートを作成する場合は、イベントを処理するメソッドを指定します。イベントをイベントハンドラに関連付けるには、デリゲートのインスタンスをイベントに追加します。デリゲートを削除しない限り、そのイベントが発生すると常にイベントハンドラが呼び出されます。パフォーマンス上の理由から、マネージコードでは既定のイベント対象は無効ですが、イベントハンドラを追加すると自動的に有効になります。

マウスの右ボタンを離した場合、2 つの CursorButtonUp イベントを受け取ります。1 つは離された右ボタンに対するイベントで、もう 1 つは離された左ボタンに対するイベントです。

例

次の例では、CursorInRange イベント、CursorButtonDown イベント、および CursorButtonUp イベントにサブスクライブし、インク自体とは異なる色を使用して、インクポインタ (マウスを利用してインクを使用する場合) を表示する方法を示します。

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

CursorButtonDown イベントが発生するときに、イベントに提供された Cursor オブジェクトがマウスであるかどうかを確認するチェックが行われます。マウスである場合は、Color() プロパティが青に設定されます。

Private Sub mInkObject_CursorButtonDown(ByVal sender As Object, ByVal e As InkCollectorCursorButtonDownEventArgs)
    Const MOUSE_CURSOR_ID As Integer = 1
    If (MOUSE_CURSOR_ID = e.Cursor.Id) Then
        e.Cursor.DrawingAttributes.Color = Color.Blue
    End If
End Sub

private void mInkObject_CursorButtonDown(object sender, InkCollectorCursorButtonDownEventArgs e)
{
    const int MOUSE_CURSOR_ID = 1;

    if (MOUSE_CURSOR_ID == e.Cursor.Id)
    {
        e.Cursor.DrawingAttributes.Color = Color.Blue;
    }

}

CursorButtonUp イベントが発生するときに、イベントに提供された Cursor オブジェクトがマウスであるかどうかを確認するチェックが行われます。マウスである場合は、Color() プロパティが再度赤に設定されます。

Private Sub mInkObject_CursorButtonUp(ByVal sender As Object, ByVal e As InkCollectorCursorButtonUpEventArgs)
    Const MOUSE_CURSOR_ID As Integer = 1
    If (MOUSE_CURSOR_ID = e.Cursor.Id) Then
        e.Cursor.DrawingAttributes.Color = Color.Red
    End If
End Sub

private void mInkObject_CursorButtonUp(object sender, InkCollectorCursorButtonUpEventArgs e)
{
    const int MOUSE_CURSOR_ID = 1;

    if (MOUSE_CURSOR_ID == e.Cursor.Id)
    {
        e.Cursor.DrawingAttributes.Color = Color.Red;
    }
}