InkOverlaySelectionMovingEventHandler Delegate

Article
10/19/2012

Represents the method that handles the SelectionMoving event of an InkOverlay object.

Namespace: Microsoft.Ink
Assembly: Microsoft.Ink (in Microsoft.Ink.dll)

Syntax

'Declaration
Public Delegate Sub InkOverlaySelectionMovingEventHandler ( _
    sender As Object, _
    e As InkOverlaySelectionMovingEventArgs _
)
'Usage
Dim instance As New InkOverlaySelectionMovingEventHandler(AddressOf HandlerMethod)

public delegate void InkOverlaySelectionMovingEventHandler(
    Object sender,
    InkOverlaySelectionMovingEventArgs e
)

public delegate void InkOverlaySelectionMovingEventHandler(
    Object^ sender, 
    InkOverlaySelectionMovingEventArgs^ e
)

JScript does not support delegates.

Parameters

sender
Type: System.Object

The source InkOverlay object of this event.

e
Type: Microsoft.Ink.InkOverlaySelectionMovingEventArgs

The InkOverlaySelectionMovingEventArgs object that contains the event data.

Remarks

The SelectionMoving event occurs when the position of the current selection is about to change, such as through alterations to the user interface, cut-and-paste procedures, or the Selection property.

When you create an InkOverlaySelectionMovingEventHandler delegate, you identify the method that handles the event. To associate the event with your event handler, add an instance of the delegate to the event. The event handler is called whenever the event occurs, unless you remove the delegate. For performance reasons, the default event interest is off in managed code but is turned on automatically if you add an event handler.

Examples

In this example, an SelectionMoving event handler examines a selection before it has been moved. If the selection will be moved so that any of it is outside the bounds of the window, the event handler turns the selection red by changing the Color property of each selected Stroke object.

Private Sub mInkObject_SelectionMoving(ByVal sender As Object, ByVal e As InkOverlaySelectionMovingEventArgs)
    If e.NewPixelRect.Left < 0 Or e.NewPixelRect.Top < 0 Or _
       e.NewPixelRect.Right > mInkObject.AttachedControl.ClientRectangle.Width Or _
       e.NewPixelRect.Bottom > mInkObject.AttachedControl.ClientRectangle.Height Then 

        For Each stroke As Stroke In mInkObject.Selection
            ' change the stroke color
            stroke.DrawingAttributes.Color = Color.Red
        Next 

    End If 
End Sub

private void mInkObject_SelectionMoving(object sender, InkOverlaySelectionMovingEventArgs e)
{
    if (e.NewPixelRect.Left < 0 || e.NewPixelRect.Top < 0 ||
        e.NewPixelRect.Right > mInkObject.AttachedControl.ClientRectangle.Width ||
        e.NewPixelRect.Bottom > mInkObject.AttachedControl.ClientRectangle.Height)
    {
        foreach (Stroke stroke in mInkObject.Selection)
        {
            // change the stroke color
            stroke.DrawingAttributes.Color = Color.Red;
        }
    }
}

Platforms

Windows 7, Windows Vista, Windows Server 2008 R2, Windows Server 2008

The .NET Framework and .NET Compact Framework do not support all versions of every platform. For a list of the supported versions, see .NET Framework System Requirements.

Version Information

.NET Framework

Supported in: 3.0

Share via