ListView.HitTest Methode

Definitie

Naamruimte:
System.Windows.Forms
Assembly:
System.Windows.Forms.dll

Bevat itemgegevens, op basis van een x- en y-coördinaat.

Overloads

Name Description
HitTest(Point)

Bevat itemgegevens, op basis van een punt.
HitTest(Int32, Int32)

Bevat itemgegevens, opgegeven x- en y-coördinaten.

HitTest(Point)

Bron:
ListView.cs
Bron:
ListView.cs
Bron:
ListView.cs
Bron:
ListView.cs
Bron:
ListView.cs

Bevat itemgegevens, op basis van een punt.

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

Parameters

point
Point

De Point gegevens van het item worden opgehaald. De coördinaten zijn relatief ten opzichte van de linkerbovenhoek van het besturingselement.

Retouren

ListViewHitTestInfo

De itemgegevens, op basis van een punt.

Uitzonderingen

ArgumentOutOfRangeException

Het punt bevat coördinaten die kleiner zijn dan 0.

Opmerkingen

Gebruik deze methode om te bepalen of een punt zich in een item of subitem bevindt en waar zich in het item het punt bevindt, zoals op het label of het afbeeldingsgebied. Als de coördinaten zich buiten het besturingselement bevinden, heeft het geretourneerde ListViewHitTestInfo object een Location eigenschap 'Geen'; en de Item eigenschappen SubItem zijn ingesteld op null.

Van toepassing op

HitTest(Int32, Int32)

Bron:
ListView.cs
Bron:
ListView.cs
Bron:
ListView.cs
Bron:
ListView.cs
Bron:
ListView.cs

Bevat itemgegevens, opgegeven x- en y-coördinaten.

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

Parameters

x
Int32

De x-coördinaat waarop de itemgegevens moeten worden opgehaald. De coördinaat is relatief ten opzichte van de linkerbovenhoek van het besturingselement.

y
Int32

De y-coördinaat waarop de itemgegevens moeten worden opgehaald. De coördinaat is relatief ten opzichte van de linkerbovenhoek van het besturingselement.

Retouren

ListViewHitTestInfo

De itemgegevens, gegeven x- en y-coördinaten.

Uitzonderingen

ArgumentOutOfRangeException

De x- of y-coördinaat is kleiner dan 0.

Voorbeelden

In het volgende codevoorbeeld ziet u hoe u de HitTest methode gebruikt om de locatie van een muis-gebeurtenis in een ListViewte bepalen. Als u dit voorbeeld wilt uitvoeren, plakt u het in een Windows formulier dat een ListView met de naam listView1 bevat die is gevuld met items. Koppel de MouseDown gebeurtenis aan listView1 de listView1_MouseDown methode in dit voorbeeld.

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

Opmerkingen

Gebruik deze methode om te bepalen of een punt zich in een item of subitem bevindt en waar zich in het item het punt bevindt, zoals op het label of het afbeeldingsgebied. Als de coördinaten zich buiten het besturingselement bevinden, heeft het geretourneerde ListViewHitTestInfo object een Location eigenschap 'Geen'; en de Item eigenschappen SubItem zijn ingesteld op null.

Van toepassing op