閱讀英文

共用方式為


InkCollectorCursorButtonDownEventHandler 委派

表示處理 InkCollector 物件之 CursorButtonDown 事件的方法。

命名空間:  Microsoft.Ink
組件:  Microsoft.Ink (在 Microsoft.Ink.dll 中)

語法

'宣告
Public Delegate Sub InkCollectorCursorButtonDownEventHandler ( _
    sender As Object, _
    e As InkCollectorCursorButtonDownEventArgs _
)
'用途
Dim instance As New InkCollectorCursorButtonDownEventHandler(AddressOf HandlerMethod)
public delegate void InkCollectorCursorButtonDownEventHandler(
    Object sender,
    InkCollectorCursorButtonDownEventArgs e
)
public delegate void InkCollectorCursorButtonDownEventHandler(
    Object^ sender, 
    InkCollectorCursorButtonDownEventArgs^ e
)
/** @delegate */
public delegate void InkCollectorCursorButtonDownEventHandler(
    Object sender,
    InkCollectorCursorButtonDownEventArgs e
)
JScript 不支援委派。

參數

備註

當使用者將畫筆接近「數位板」並開始描繪筆劃時,筆尖上的按鈕是按下的。按下筆桿上的按鈕時,按鈕會處於按下狀態。

在建立 InkCollectorCursorButtonDownEventHandler 委派 (Delegate) 時,您要識別處理事件的方法。若要使事件與您的事件處理常式產生關聯,請將委派的執行個體加入至事件。除非您移除委派,否則每當事件發生時就會呼叫事件處理常式。基於效能考量,相關事件的預設是關閉的,但會在您加入事件處理常式時自動在「Managed 程式碼」中開啟。

在按滑鼠右鍵時,實際上會接收兩個 CursorButtonDown 事件,一是滑鼠右鍵按下的事件,二是滑鼠左鍵按下的事件。

範例

在下列範例中,會說明如何訂閱 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;
    }
}

平台

Windows Vista

.NET Framework 和 .NET Compact Framework 並不支援各種平台的所有版本。如需支援平台版本的相關資訊,請參閱 .NET Framework 系統需求

版本資訊

.NET Framework

支援版本:3.0

請參閱

參考

Microsoft.Ink 命名空間

CursorButton

InkCollector.CursorButtonDown

InkCollector

InkCollectorCursorButtonDownEventArgs