ListView.HitTest ListView.HitTest ListView.HitTest ListView.HitTest Method

정의

주어진 X, Y 좌표의 항목 정보를 제공합니다.Provides item information, given an x- and y-coordinate.

오버로드

HitTest(Point) HitTest(Point) HitTest(Point)

주어진 지점의 항목 정보를 제공합니다.Provides item information, given a point.

HitTest(Int32, Int32) HitTest(Int32, Int32) HitTest(Int32, Int32) HitTest(Int32, Int32)

주어진 X, Y 좌표의 항목 정보를 제공합니다.Provides item information, given x- and y-coordinates.

HitTest(Point) HitTest(Point) HitTest(Point)

주어진 지점의 항목 정보를 제공합니다.Provides item information, given a 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

매개 변수

point
Point Point Point Point

Point 항목 정보를 검색할 수입니다.The Point at which to retrieve the item information. 좌표는 컨트롤의 왼쪽 위 모퉁이가 기준입니다.The coordinates are relative to the upper-left corner of the control.

반환

주어진 지점의 항목 정보입니다.The item information, given a point.

예외

0 보다 작은 좌표를 포함 하는 지점입니다.The point contains coordinates that are less than 0.

설명

항목이 나 하위 항목에 점이 있는지 여부 및 항목에는 지점 위치한 같은 레이블 또는 이미지 영역에 확인 하려면이 메서드를 사용 합니다.Use this method to determine whether a point is in an item or subitem and where in the item the point is located, such as on the label or image area. 컨트롤에서 반환된 된 외부 좌표에 위치한 경우 ListViewHitTestInfo 개체에는 Location "none"; 속성 및 Item 하 고 SubItem 속성으로 설정 됩니다 null.If the coordinates are located outside the control, the returned ListViewHitTestInfo object has a Location property of "None"; and the Item and SubItem properties are set to null.

HitTest(Int32, Int32) HitTest(Int32, Int32) HitTest(Int32, Int32) HitTest(Int32, Int32)

주어진 X, Y 좌표의 항목 정보를 제공합니다.Provides item information, given x- and y-coordinates.

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 Int32 Int32 Int32

항목 정보를 검색할 X 좌표입니다.The x-coordinate at which to retrieve the item information. 좌표는 컨트롤의 왼쪽 위 모퉁이가 기준입니다.The coordinate is relative to the upper-left corner of the control.

y
Int32 Int32 Int32 Int32

항목 정보를 검색할 Y 좌표입니다.The y-coordinate at which to retrieve the item information. 좌표는 컨트롤의 왼쪽 위 모퉁이가 기준입니다.The coordinate is relative to the upper-left corner of the control.

반환

주어진 X, Y 좌표의 항목 정보입니다.The item information, given x- and y- coordinates.

예외

X 또는 y 좌표가 0 보다 작은 경우The x- or y-coordinate is less than 0.

예제

다음 코드 예제에서는 합니다 HitTest 에서 마우스 이벤트의 위치를 결정 하는 메서드는 ListView.The following code example demonstrates using the HitTest method to determine the location of a mouse event in a ListView. 이 예제를 실행 하려면 포함 하는 Windows 폼에 붙여넣습니다를 ListView 라는 listView1 하는 항목으로 채워집니다.To run this example, paste it into a Windows Form that contains a ListView named listView1 that is populated with items. 연결 된 MouseDown 이벤트에 대 한 listView1 사용 하 여는 listView1_MouseDown 이 예제의 메서드.Associate the MouseDown event for listView1 with the listView1_MouseDown method in this example.

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

설명

항목 또는 하위 항목에 점이 있는지 여부 및 항목에는 지점 위치한 같은 레이블 또는 이미지 영역을 확인 하려면이 메서드를 사용 합니다.Use this method to determine whether a point is in an item or subitem, and where in the item the point is located, such as on the label or image area. 컨트롤에서 반환된 된 외부 좌표에 위치한 경우 ListViewHitTestInfo 개체에는 Location "none"; 속성 및 Item 하 고 SubItem 속성으로 설정 됩니다 null.If the coordinates are located outside the control, the returned ListViewHitTestInfo object has a Location property of "None"; and the Item and SubItem properties are set to null.

적용 대상