InkOverlay.SelectionChanging 事件

發行項
10/29/2008

會在控制項內選取的筆墨即將透過如更改使用者介面、剪貼程序或 Selection 屬性等方式變更時發生。

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

語法

'宣告
Public Event SelectionChanging As InkOverlaySelectionChangingEventHandler
'用途
Dim instance As InkOverlay
Dim handler As InkOverlaySelectionChangingEventHandler

AddHandler instance.SelectionChanging, handler

public event InkOverlaySelectionChangingEventHandler SelectionChanging

public:
 event InkOverlaySelectionChangingEventHandler^ SelectionChanging {
    void add (InkOverlaySelectionChangingEventHandler^ value);
    void remove (InkOverlaySelectionChangingEventHandler^ value);
}

/** @event */
public void add_SelectionChanging (InkOverlaySelectionChangingEventHandler value)
/** @event */
public void remove_SelectionChanging (InkOverlaySelectionChangingEventHandler value)

JScript 不支援事件。

備註

事件處理常式會收到 InkOverlaySelectionChangingEventArgs 型別的引數，其中包含這個事件的相關資料。

您可以處理這個事件來變更 InkOverlay 物件的預設選取行為。

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

範例

在這個範例中，SelectionChanging 事件處理常式會藉由從目前選取範圍中移除所有物件，只剩下一個 Stroke 物件的方式，禁止選取多個筆劃。

Private Sub mInkObject_SelectionChanging(ByVal sender As Object, ByVal e As InkOverlaySelectionChangingEventArgs)
    While e.NewSelection.Count > 1
        e.NewSelection.RemoveAt(e.NewSelection.Count - 1)
    End While
End Sub

private void mInkObject_SelectionChanging(object sender, InkOverlaySelectionChangingEventArgs e)
{
    while (e.NewSelection.Count > 1)
    {
        e.NewSelection.RemoveAt(e.NewSelection.Count - 1);
    }
}