This documentation is archived and is not being maintained.

InkCanvasSelectionHitResult Enumeration

Identifies the various parts of a selection adorner on an InkCanvas.

Namespace:  System.Windows.Controls
Assembly:  PresentationFramework (in PresentationFramework.dll)

Public Enumeration InkCanvasSelectionHitResult
Dim instance As InkCanvasSelectionHitResult
This class is not typically used in XAML.

Member nameDescription
NoneNo part of the selection adorner.
TopLeftThe upper left handle of the selection adorner.
TopThe upper middle handle of the selection adorner.
TopRightThe upper right handle of the selection adorner.
RightThe middle handle on the right edge of the selection adorner.
BottomRightThe lower right handle of the selection adorner.
BottomThe lower middle handle of the selection adorner.
BottomLeftThe lower left handle of the selection adorner.
LeftThe middle handle on the left edge of the selection adorner.
SelectionThe area within the bounds of the selection adorner.

The HitTestSelection method returns an InkCanvasSelectionHitResult to indicate which part of the selection adorner intersects or surrounds a Point. This is useful when performing drag-and-drop operations.

The following example demonstrates how use HitTestSelection to determine whether to create a DataObject to initiate drag and drop. To implement drag and drop between two InkCanvas objects, see How to: Drag and Drop Ink.

Private Sub InkCanvas_PreviewMouseDown(ByVal sender As Object, _
                               ByVal e As MouseButtonEventArgs)

    Dim ic As InkCanvas = CType(sender, InkCanvas)

    Dim pt As Point = e.GetPosition(ic)

    ' If the user is moving selected strokes, prepare the strokes to be 
    ' moved to another InkCanvas. 
    If ic.HitTestSelection(pt) = InkCanvasSelectionHitResult.Selection Then 

        Dim selectedStrokes As StrokeCollection = _

        Dim strokesToMove As StrokeCollection = _

        ' Remove the offset of the selected strokes so they 
        ' are positioned when the strokes are dropped. 
        Dim inkBounds As Rect = strokesToMove.GetBounds()
        TranslateStrokes(strokesToMove, -inkBounds.X, -inkBounds.Y)

        ' Perform drag and drop. 
        Dim ms As New MemoryStream()

        Dim dataObject As New DataObject _
            (StrokeCollection.InkSerializedFormat, ms)

        Dim effects As DragDropEffects = _
            DragDrop.DoDragDrop(ic, dataObject, DragDropEffects.Move)

        If (effects And DragDropEffects.Move) = DragDropEffects.Move Then 

            ' Remove the selected strokes from the current InkCanvas.
        End If 
    End If 

End Sub 'OnMouseDown

Windows 7, Windows Vista, Windows XP SP2, Windows Server 2008 R2, Windows Server 2008, Windows Server 2003

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.

.NET Framework

Supported in: 3.5, 3.0