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 마우스 좌표는 이 메서드 호출의 x 및 y 매개 변수 값에 사용됩니다.

반환되는 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 개체는 선택한 실제 개체의 인스턴스(있는 경우)를 제공합니다.