InkPicture.HitTestSelection-Methode

Artikel
10/28/2008

Gibt einen Wert zurück, der angibt, welcher Teil einer Auswahl (sofern vorhanden) während eines Treffertests gefunden wurde.

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

Syntax

'Declaration
Public Function HitTestSelection ( _
    X As Integer, _
    Y As Integer _
) As SelectionHitResult
'Usage
Dim instance As InkPicture
Dim X As Integer
Dim Y As Integer
Dim returnValue As SelectionHitResult

returnValue = instance.HitTestSelection(X, _
    Y)

public SelectionHitResult HitTestSelection(
    int X,
    int Y
)

public:
SelectionHitResult HitTestSelection(
    int X, 
    int Y
)

public SelectionHitResult HitTestSelection(
    int X,
    int Y
)

public function HitTestSelection(
    X : int, 
    Y : int
) : SelectionHitResult

Parameter

X
Typ: System.Int32
Die x-Position, in Pixeln, des Treffertests.

Y
Typ: System.Int32
Die y-Position, in Pixeln, des Treffertests.

Rückgabewert

Typ: Microsoft.Ink.SelectionHitResult
Ein Member der SelectionHitResult-Enumeration, der angibt, welcher Teil einer Auswahl (sofern vorhanden) während eines Treffertests gefunden wurde.

Hinweise

Diese Methode ist nur sinnvoll, wenn die InkPicture.EditingMode-Eigenschaft auf Select festgelegt ist.

Beispiele

In diesem Beispiel wird bei Auslösen des MouseDown()-Ereignisses überprüft, ob EditingMode auf Select festgelegt ist. Wenn dies der Fall ist, wird die HitTestSelection-Methode aufgerufen, um zu bestimmen, welcher Teil der Auswahl (sofern zutreffend) gefunden wurde. Wenn der Treffer in einer der vier Kompasshauptrichtungen auftritt (wie von der SelectionHitResult-Enumeration angegeben), wird die Farbe der ausgewählten Strichobjekte geändert.

Private Sub mInkPicture_MouseDown(ByVal sender As Object, ByVal e As MouseEventArgs)

    If InkOverlayEditingMode.Select = mInkPicture.EditingMode Then
        Select Case mInkObject.HitTestSelection(e.X, e.Y)
            Case SelectionHitResult.North
                ChangeSelectionColor(Color.Green)
            Case SelectionHitResult.East
                ChangeSelectionColor(Color.Red)
            Case SelectionHitResult.South
                ChangeSelectionColor(Color.Purple)
            Case SelectionHitResult.West
                ChangeSelectionColor(Color.Blue)
        End Select
    End If
End Sub

private void mInkPicture_MouseDown(object sender, MouseEventArgs e)
{
    if (InkOverlayEditingMode.Select == mInkPicture.EditingMode)
    {
        switch (mInkObject.HitTestSelection(e.X, e.Y))
        {
            case SelectionHitResult.North:
                ChangeSelectionColor(Color.Green);
                break;
            case SelectionHitResult.East:
                ChangeSelectionColor(Color.Red);
                break;
            case SelectionHitResult.South:
                ChangeSelectionColor(Color.Purple);
                break;
            case SelectionHitResult.West:
                ChangeSelectionColor(Color.Blue);
                break;
        }
    }
}

Plattformen

Windows Vista

.NET Framework und .NET Compact Framework unterstützen nicht alle Versionen sämtlicher Plattformen. Eine Liste der unterstützten Versionen finden Sie unter Systemanforderungen für .NET Framework.