Chart.HitTest 메서드

정의

네임스페이스:

System.Windows.Forms.DataVisualization.Charting

어셈블리:

System.Windows.Forms.DataVisualization.dll

지정된 X 및 Y 좌표로 정의되는 요소에 있는 차트 요소(있는 경우)를 결정합니다.

오버로드

HitTest(Int32, Int32)	지정된 X 및 Y 좌표로 정의되는 요소에 있는 차트 요소(있는 경우)를 결정합니다.
HitTest(Int32, Int32, Boolean)	지정된 X 및 Y 좌표로 정의되는 요소에 있는 차트 요소(있는 경우)를 결정합니다. 선택적으로 투명 요소는 무시될 수 있습니다.
HitTest(Int32, Int32, ChartElementType)	지정된 X 및 Y 좌표로 정의되는 요소에 지정된 형식의 차트 요소가 있는지 여부를 결정합니다.
HitTest(Int32, Int32, Boolean, ChartElementType[])	지정된 형식 중 하나인 차트 요소가 지정된 X 및 Y 좌표로 정의되는 지점에 위치하는지 여부를 결정합니다.

설명

지정된 지점에 있는 차트 요소(있는 경우)를 확인하려면 이 메서드를 호출합니다.

이 메서드는 일부 마우스 관련 이벤트(예 OnMouseDown : )에서 최종 사용자가 클릭한 차트 요소를 결정하는 데 자주 사용됩니다. 그런 다음 이벤트 매개 변수에서 가져온 X 및 Y 마우스 좌표가 이 메서드 호출의 매개 변수 값 및 y 매개 변수에 사용됩니다x.

반환되는 개체의 HitTestResult 속성을 사용하여 클릭한 HitTestResult 차트 요소를 확인할 수 있습니다. 개체는 선택한 실제 개체의 인스턴스(있는 경우)도 제공합니다.

HitTest(Int32, Int32)

지정된 X 및 Y 좌표로 정의되는 요소에 있는 차트 요소(있는 경우)를 결정합니다.

public:
 System::Windows::Forms::DataVisualization::Charting::HitTestResult ^ HitTest(int x, int y);

public System.Windows.Forms.DataVisualization.Charting.HitTestResult HitTest (int x, int y);

member this.HitTest : int * int -> System.Windows.Forms.DataVisualization.Charting.HitTestResult

Public Function HitTest (x As Integer, y As Integer) As HitTestResult

매개 변수

x

Int32

사용자가 클릭한 요소의 X 좌표 값입니다.

y

Int32

사용자가 클릭한 요소의 Y 좌표 값입니다.

반환

HitTestResult

지정된 위치에 차트 요소가 있는 경우 이 요소에 대한 정보를 제공하는 HitTestResult 개체입니다.

설명

지정된 지점에 있는 차트 요소(있는 경우)를 확인하려면 이 메서드를 호출합니다.

반환되는 개체의 HitTestResult 속성을 사용하여 클릭한 HitTestResult 차트 요소를 확인할 수 있습니다. 개체는 선택한 실제 개체의 인스턴스(있는 경우)도 제공합니다.

HitTest(Int32, Int32, Boolean)

지정된 X 및 Y 좌표로 정의되는 요소에 있는 차트 요소(있는 경우)를 결정합니다. 선택적으로 투명 요소는 무시될 수 있습니다.

public:
 System::Windows::Forms::DataVisualization::Charting::HitTestResult ^ HitTest(int x, int y, bool ignoreTransparent);

public System.Windows.Forms.DataVisualization.Charting.HitTestResult HitTest (int x, int y, bool ignoreTransparent);

member this.HitTest : int * int * bool -> System.Windows.Forms.DataVisualization.Charting.HitTestResult

Public Function HitTest (x As Integer, y As Integer, ignoreTransparent As Boolean) As HitTestResult

매개 변수

x

Int32

사용자가 클릭한 요소의 X 좌표 값입니다.

y

Int32

사용자가 클릭한 요소의 Y 좌표 값입니다.

ignoreTransparent

Boolean

투명 요소를 무시하려면 true이고, 그렇지 않으면 false입니다.

반환

HitTestResult

지정된 위치에 차트 요소가 있는 경우 이 요소에 대한 정보를 제공하는 HitTestResult 개체입니다.

설명

지정된 지점에 있는 차트 요소(있는 경우)를 확인하려면 이 메서드를 호출합니다.

투명한 요소를 무시하려면 매개 변수를 ignoreTransparent .로 true설정합니다.

반환되는 개체의 HitTestResult 속성을 사용하여 클릭한 HitTestResult 차트 요소를 확인할 수 있습니다. 개체는 선택한 실제 개체의 인스턴스(있는 경우)도 제공합니다.

HitTest(Int32, Int32, ChartElementType)

지정된 X 및 Y 좌표로 정의되는 요소에 지정된 형식의 차트 요소가 있는지 여부를 결정합니다.

public:
 System::Windows::Forms::DataVisualization::Charting::HitTestResult ^ HitTest(int x, int y, System::Windows::Forms::DataVisualization::Charting::ChartElementType requestedElement);

public System.Windows.Forms.DataVisualization.Charting.HitTestResult HitTest (int x, int y, System.Windows.Forms.DataVisualization.Charting.ChartElementType requestedElement);

member this.HitTest : int * int * System.Windows.Forms.DataVisualization.Charting.ChartElementType -> System.Windows.Forms.DataVisualization.Charting.HitTestResult

Public Function HitTest (x As Integer, y As Integer, requestedElement As ChartElementType) As HitTestResult

매개 변수

x

Int32

사용자가 클릭한 요소의 X 좌표 값입니다.

y

Int32

사용자가 클릭한 요소의 Y 좌표 값입니다.

requestedElement

ChartElementType

테스트할 차트 요소 형식을 결정하는 플래그입니다.

반환

HitTestResult

지정된 위치에 차트 요소가 있는 경우 이 요소에 대한 정보를 제공하는 HitTestResult 개체입니다.

설명

지정된 형식의 차트 요소가 지정된 지점에 있는지 확인하려면 이 메서드를 호출합니다.

반환되는 개체의 HitTestResult 속성을 사용하여 클릭한 HitTestResult 차트 요소를 확인할 수 있습니다. 개체는 선택한 실제 개체의 인스턴스(있는 경우)도 제공합니다.

HitTest(Int32, Int32, Boolean, ChartElementType[])

지정된 형식 중 하나인 차트 요소가 지정된 X 및 Y 좌표로 정의되는 지점에 위치하는지 여부를 결정합니다.

public:
 cli::array <System::Windows::Forms::DataVisualization::Charting::HitTestResult ^> ^ HitTest(int x, int y, bool ignoreTransparent, ... cli::array <System::Windows::Forms::DataVisualization::Charting::ChartElementType> ^ requestedElement);

public System.Windows.Forms.DataVisualization.Charting.HitTestResult[] HitTest (int x, int y, bool ignoreTransparent, params System.Windows.Forms.DataVisualization.Charting.ChartElementType[] requestedElement);

member this.HitTest : int * int * bool * System.Windows.Forms.DataVisualization.Charting.ChartElementType[] -> System.Windows.Forms.DataVisualization.Charting.HitTestResult[]

Public Function HitTest (x As Integer, y As Integer, ignoreTransparent As Boolean, ParamArray requestedElement As ChartElementType()) As HitTestResult()

매개 변수

x

Int32

지정된 데이터 요소의 X 좌표입니다.

y

Int32

지정된 데이터 요소의 Y 좌표입니다.

ignoreTransparent

Boolean

투명 요소를 무시하려면 true이고, 그렇지 않으면 false입니다.

requestedElement

ChartElementType[]

결과를 필터링하기 위해 테스트할 형식을 지정하는 ChartElementType 개체 배열입니다. 생략하면 요소 형식에 대한 검사가 무시되고 모든 요소 유형이 유효해집니다.

반환

HitTestResult[]

지정된 위치에 있는 차트 요소(있는 경우)에 대한 정보를 제공하는 HitTestResult 개체입니다. 배열에 Nothing일 수 있는 하나 이상의 요소가 포함되어 있습니다. 결과의 개체는 여러 계층의 컨트롤 위쪽에서 아래쪽으로 정렬됩니다.

설명

지정된 지점에 있는 계기 요소(있는 경우)를 확인하려면 이 메서드를 호출합니다. 이 메서드는 일부 마우스 관련 이벤트(예 OnMouseDown: 최종 사용자가 클릭한 계기 요소)에서 자주 사용됩니다. 이벤트 매개 변수에서 가져온 X 및 Y 마우스 좌표는 이 메서드 호출의 X 및 Y 매개 변수 값에 사용됩니다.

반환 HitTestResult 된 개체의 속성을 사용하여 클릭한 HitTestResult 차트 요소를 확인할 수 있습니다. 개체는 선택한 실제 개체의 인스턴스(있는 경우)도 제공합니다.