Shape.HitTest, méthode

Article
05/16/2015

Obtient les informations concernant un contrôle Shape ou Line à une position spécifiée sur l'écran.

Espace de noms : Microsoft.VisualBasic.PowerPacks
Assembly : Microsoft.VisualBasic.PowerPacks.Vs (dans Microsoft.VisualBasic.PowerPacks.Vs.dll)

Syntaxe

'Déclaration
Public MustOverride Function HitTest ( _
    x As Integer, _
    y As Integer _
) As Boolean

public abstract bool HitTest(
    int x,
    int y
)

public:
virtual bool HitTest(
    int x, 
    int y
) abstract

abstract HitTest : 
        x:int * 
        y:int -> bool

public abstract function HitTest(
    x : int, 
    y : int
) : boolean

Paramètres

x
Type : Int32

Coordonnée d'écran horizontale.

y
Type : Int32

Coordonnée d'écran verticale.

Valeur de retour

Type : Boolean
true si la ligne ou le contrôle Shape se trouvent aux coordonnées spécifiées ; sinon, false.

Notes

Le x et y paramètres représentent les coordonnées actuelles de la souris par rapport à l'écran, et non pas au conteneur du contrôle.

Exemples

L'exemple suivant montre comment utiliser le HitTest procédé de la LineShape contrôle afin de déterminer si le pointeur est positionné sur le contrôle lorsque vous appuyez sur la touche espace.

Private Sub LineHitTestForm_PreviewKeyDown(
    ByVal sender As Object, 
    ByVal e As System.Windows.Forms.PreviewKeyDownEventArgs
  ) Handles Me.PreviewKeyDown

    If e.KeyCode = Keys.Space Then 
        Dim px As Integer 
        Dim py As Integer 
        Dim hit As Boolean
        px = LineHitTestForm.MousePosition.X
        py = LineHitTestForm.MousePosition.Y
        hit = LineShape1.HitTest(px, py)
        MsgBox(CStr(hit))
    End If 
End Sub

private void LineHitTestForm_PreviewKeyDown(object sender, 
    System.Windows.Forms.PreviewKeyDownEventArgs e)
{
    if (e.KeyCode == Keys.Space)
    {
        int px;
        int py;
        bool hit;
        string result;
        px = LineHitTestForm.MousePosition.X;
        py = LineHitTestForm.MousePosition.Y;
        hit = lineShape1.HitTest(px, py);
        result = hit.ToString();
        MessageBox.Show(result);
    }
}

Sécurité .NET Framework

Confiance totale accordée à l'appelant immédiat. Ce membre ne peut pas être utilisé par du code d'un niveau de confiance partiel. Pour plus d'informations, voir Utilisation de bibliothèques à partir de code d'un niveau de confiance partiel.