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)

Kaynak:

ListView.cs

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

C#

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

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)

Kaynak:

ListView.cs

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

C#

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

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.

C#

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

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.