ListView.HitTest Methode

Definition

Namespace:

System.Windows.Forms

Assembly:

System.Windows.Forms.dll

Stellt Elementinformationen bereit, wenn eine x- und eine y-Koordinate angegeben sind.

Überlädt

HitTest(Point)	Stellt Elementinformationen bereit, wenn ein Punkt angegeben ist.
HitTest(Int32, Int32)	Stellt Elementinformationen bereit, wenn x- und y-Koordinaten angegeben sind.

HitTest(Point)

Stellt Elementinformationen bereit, wenn ein Punkt angegeben ist.

public:
 System::Windows::Forms::ListViewHitTestInfo ^ HitTest(System::Drawing::Point point);

public System.Windows.Forms.ListViewHitTestInfo HitTest (System.Drawing.Point point);

member this.HitTest : System.Drawing.Point -> System.Windows.Forms.ListViewHitTestInfo

Public Function HitTest (point As Point) As ListViewHitTestInfo

Parameter

point

Point

Der Point, an dem die Elementinformationen abgerufen werden sollen. Die Koordinaten sind relativ zur linken oberen Ecke des Steuerelements.

Gibt zurück

ListViewHitTestInfo

Elementinformationen, wenn ein Punkt angegeben ist.

Ausnahmen

ArgumentOutOfRangeException

Der Punkt enthält Koordinaten, die kleiner als 0 (null) sind.

Hinweise

Verwenden Sie diese Methode, um zu bestimmen, ob sich ein Punkt in einem Element oder Unterelement befindet und wo sich der Punkt im Element befindet, z. B. auf der Bezeichnung oder im Bildbereich. Wenn sich die Koordinaten außerhalb des Steuerelements befinden, weist das zurückgegebene ListViewHitTestInfo Objekt die Location Eigenschaft "None" auf, und die Item Eigenschaften und SubItem sind auf nullfestgelegt.

HitTest(Int32, Int32)

Stellt Elementinformationen bereit, wenn x- und y-Koordinaten angegeben sind.

public:
 System::Windows::Forms::ListViewHitTestInfo ^ HitTest(int x, int y);

public System.Windows.Forms.ListViewHitTestInfo HitTest (int x, int y);

member this.HitTest : int * int -> System.Windows.Forms.ListViewHitTestInfo

Public Function HitTest (x As Integer, y As Integer) As ListViewHitTestInfo

Parameter

x

Int32

Die x-Koordinate, an der die Elementinformationen abgerufen werden sollen. Die Koordinate ist relativ zur linken oberen Ecke des Steuerelements.

y

Int32

Die y-Koordinate, an der die Elementinformationen abgerufen werden sollen. Die Koordinate ist relativ zur linken oberen Ecke des Steuerelements.

Gibt zurück

ListViewHitTestInfo

Elementinformationen, wenn x- und y-Koordinaten angegeben sind.

Ausnahmen

ArgumentOutOfRangeException

Die x- oder y-Koordinate ist kleiner als 0 (null).

Beispiele

Das folgende Codebeispiel veranschaulicht die Verwendung der HitTest -Methode, um die Position eines Mausereignisses in einem ListViewzu bestimmen. Um dieses Beispiel auszuführen, fügen Sie es in ein Windows Form-Formular ein, das einen ListView benannten listView1 enthält, der mit Elementen aufgefüllt ist. Ordnen Sie das MouseDown Ereignis für listView1 der listView1_MouseDown -Methode in diesem Beispiel zu.

void HandleMouseDown(object sender, MouseEventArgs e)
{
    ListViewHitTestInfo info = listView1.HitTest(e.X, e.Y);
    MessageBox.Show(info.Location.ToString());
}

Private Sub HandleMouseDown(ByVal sender As Object, ByVal e As MouseEventArgs) _
        Handles Me.MouseDown, listView1.MouseDown

    Dim info As ListViewHitTestInfo = listView1.HitTest(e.X, e.Y)
    MessageBox.Show(info.Location.ToString())

End Sub

Hinweise

Verwenden Sie diese Methode, um zu bestimmen, ob sich ein Punkt in einem Element oder Unterelement befindet und wo sich der Punkt im Element befindet, z. B. in der Bezeichnung oder im Bildbereich. Wenn sich die Koordinaten außerhalb des Steuerelements befinden, weist das zurückgegebene ListViewHitTestInfo Objekt die Location Eigenschaft "None" auf, und die Item Eigenschaften und SubItem sind auf nullfestgelegt.