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 объект также предоставляет экземпляр выбранного объекта, если таковой имеется.

Применяется к