InkPicture.HitTestSelection, méthode

Article
11/05/2008

Mise à jour : November 2007

Retourne une valeur qui indique quelle partie d'une sélection, si elle existe, a été atteinte pendant un test de positionnement.

Espace de noms : Microsoft.Ink
Assembly : Microsoft.Ink (dans Microsoft.Ink.dll)

Syntaxe

'Déclaration
Public Function HitTestSelection ( _
    X As Integer, _
    Y As Integer _
) As SelectionHitResult
'Utilisation
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

Paramètres

X
Type : System.Int32
Position x, en pixels, du test de positionnement.

Y
Type : System.Int32
Position y, en pixels, du test de positionnement.

Valeur de retour

Type : Microsoft.Ink.SelectionHitResult
Membre de l'énumération SelectionHitResult, qui spécifie quelle partie d'une sélection, si elle existe, a été atteinte pendant un test de positionnement.

Notes

Cette méthode est utile uniquement si la propriété InkPicture.EditingMode a la valeur Sélection.

Exemples

Dans cet exemple, lorsque l'événement MouseDown() se déclenche, un contrôle vérifie si la valeur Select est affectée à la propriété EditingMode. Dans ce cas, la méthode HitTestSelection est appelée pour déterminer la partie de la sélection (le cas échéant) qui a été atteinte. Si l'accès se produit sur une des quatre directions de compas principales, comme spécifié par l'énumération SelectionHitResult, les objets de trait sélectionnés prennent une couleur différente.

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;
        }
    }
}

Plateformes

Windows Vista

Le .NET Framework et le .NET Compact Framework ne prennent pas en charge toutes les versions de chaque plateforme. Pour obtenir la liste des versions prises en charge, consultez Configuration requise du .NET Framework.