ListView.HitTest 메서드

정의

네임스페이스:

System.Windows.Forms

어셈블리:

System.Windows.Forms.dll

주어진 X, Y 좌표의 항목 정보를 제공합니다.

오버로드

HitTest(Point)	주어진 지점의 항목 정보를 제공합니다.
HitTest(Int32, Int32)	주어진 X, Y 좌표의 항목 정보를 제공합니다.

HitTest(Point)

주어진 지점의 항목 정보를 제공합니다.

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

매개 변수

point

Point

항목 정보를 검색할 Point입니다. 좌표는 컨트롤의 왼쪽 위 모퉁이가 기준입니다.

반환

ListViewHitTestInfo

주어진 지점의 항목 정보입니다.

예외

ArgumentOutOfRangeException

지점에 0보다 작은 좌표가 포함된 경우

설명

이 메서드를 사용하여 점이 항목 또는 하위 항목에 있는지 여부와 항목의 위치(예: 레이블 또는 이미지 영역)를 확인합니다. 좌표가 컨트롤 외부에 있는 경우 반환 ListViewHitTestInfo 된 개체의 속성은 Location "None"이고 및 ItemSubItem 속성은 로 null설정됩니다.

HitTest(Int32, Int32)

주어진 X, Y 좌표의 항목 정보를 제공합니다.

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

매개 변수

x

Int32

항목 정보를 검색할 X 좌표입니다. 좌표는 컨트롤의 왼쪽 위 모퉁이가 기준입니다.

y

Int32

항목 정보를 검색할 Y 좌표입니다. 좌표는 컨트롤의 왼쪽 위 모퉁이가 기준입니다.

반환

ListViewHitTestInfo

주어진 X, Y 좌표의 항목 정보입니다.

예외

ArgumentOutOfRangeException

X 또는 Y 좌표가 0보다 작은 경우

예제

다음 코드 예제에서는 메서드를 HitTest 사용 하 여 에서 마우스 이벤트의 위치를 확인 하는 방법을 보여 줍니다 ListView. 이 예제를 실행하려면 항목으로 채워진 이름이 listView1 포함된 ListView Windows Form에 붙여넣습니다. 에 MouseDown 대한 listView1 이벤트를 이 예제의 listView1_MouseDown 메서드와 연결합니다.

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

설명

이 메서드를 사용하여 점이 항목 또는 하위 항목에 있는지 여부와 항목의 위치(예: 레이블 또는 이미지 영역)를 확인합니다. 좌표가 컨트롤 외부에 있는 경우 반환 ListViewHitTestInfo 된 개체의 속성은 Location "None"이고 및 ItemSubItem 속성은 로 null설정됩니다.