ListView.HitTest Yöntem

Tanım

Ad Alanı:

System.Windows.Forms

Bütünleştirilmiş Kod:

System.Windows.Forms.dll

X ve y koordinatı verilerek öğe bilgilerini sağlar.

Aşırı Yüklemeler

HitTest(Point)	Bir noktaya göre öğe bilgilerini sağlar.
HitTest(Int32, Int32)	x ve y koordinatları verilen öğe bilgilerini sağlar.

HitTest(Point)

Bir noktaya göre öğe bilgilerini sağlar.

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

Parametreler

point

Point

Point Öğe bilgilerinin alındığı yer. Koordinatlar denetimin sol üst köşesine göredir.

Döndürülenler

ListViewHitTestInfo

Belirli bir noktaya gelinen öğe bilgileri.

Özel durumlar

ArgumentOutOfRangeException

Nokta, 0'dan küçük koordinatlar içerir.

Açıklamalar

Bir noktanın bir öğede mi yoksa alt öğede mi olduğunu ve etiket veya görüntü alanı gibi öğenin neresinde bulunduğunu belirlemek için bu yöntemi kullanın. Koordinatlar denetimin dışında yer alıyorsa, döndürülen ListViewHitTestInfo nesnenin "None" özelliği vardır Location ve ve ItemSubItem özellikleri olarak nullayarlanır.

HitTest(Int32, Int32)

x ve y koordinatları verilen öğe bilgilerini sağlar.

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

Parametreler

x

Int32

Öğe bilgilerinin alındığı x koordinatı. Koordinat, denetimin sol üst köşesine göredir.

y

Int32

Öğe bilgilerinin alındığı y koordinatı. Koordinat, denetimin sol üst köşesine göredir.

Döndürülenler

ListViewHitTestInfo

x ve y koordinatları verilen öğe bilgileri.

Özel durumlar

ArgumentOutOfRangeException

x veya y koordinatı 0'dan küçüktür.

Örnekler

Aşağıdaki kod örneği, bir içindeki fare olayının ListViewkonumunu belirlemek için yönteminin kullanılmasını HitTest gösterir. Bu örneği çalıştırmak için, öğeleriyle doldurulmuş adlı bir ad listView1 içeren bir ListView Windows Formuna yapıştırın. MouseDown için listView1 olayını bu örnekteki listView1_MouseDown yöntemiyle ilişkilendirin.

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

Açıklamalar

Bir noktanın bir öğede mi yoksa alt öğede mi olduğunu ve etiket veya görüntü alanı gibi öğenin neresinde bulunduğunu belirlemek için bu yöntemi kullanın. Koordinatlar denetimin dışında yer alıyorsa, döndürülen ListViewHitTestInfo nesnenin "None" özelliği vardır Location ve ve ItemSubItem özellikleri olarak nullayarlanır.