ListView.HitTest Yöntem

Tanım

Ad Alanı:

System.Windows.Forms

Bütünleştirilmiş Kod:

System.Windows.Forms.dll

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

Aşırı Yüklemeler

Name	Description
HitTest(Point)	Belirli 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

Belirli 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

Bir nokta verilen öğ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 "Yok" özelliği vardır Location ve Item ve SubItem özellikleri olarak nullayarlanır.

HitTest(Int32, Int32)

Kaynak:

ListView.cs

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ğinde bir fare olayının HitTestListViewkonumunu belirlemek için yönteminin kullanılması gösterilmektedir. Bu örneği çalıştırmak için, öğeleriyle doldurulmuş bir adlandırılmış listView1 içeren bir ListView Windows Formu'na 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 "Yok" özelliği vardır Location ve Item ve SubItem özellikleri olarak nullayarlanır.