Chart.HitTest Метод
Определение
Важно!
Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.
Определяет элемент диаграммы( если таковой есть), расположенный в точке, определенной заданными координатами X и Y.
Перегрузки
| Имя | Описание |
|---|---|
| HitTest(Int32, Int32, Boolean, ChartElementType[]) |
Определяет, находится ли элемент диаграммы, который является одним из указанных типов, в точке, определенной заданными координатами X и Y. |
| HitTest(Int32, Int32, ChartElementType) |
Определяет, находится ли элемент диаграммы заданного типа в точке, определенной заданными координатами X и Y. |
| HitTest(Int32, Int32) |
Определяет элемент диаграммы( если таковой есть), расположенный в точке, определенной заданными координатами X и Y. |
| HitTest(Int32, Int32, Boolean) |
Определяет элемент диаграммы( если таковой имеется), расположенный в точке, определенной заданными координатами X и Y. Прозрачные элементы можно игнорировать при необходимости. |
Комментарии
Вызовите этот метод, чтобы определить элемент диаграммы( если таковой имеется), расположенный в указанной точке.
Этот метод часто используется в некоторых событиях, связанных с мышью, например MouseDown, чтобы определить, какой элемент диаграммы щелкнул конечный пользователь. Координаты мыши X и Y, полученные из параметров события, затем используются для x значений y параметров этого метода.
Затем свойства возвращаемого HitTestResult объекта можно использовать для определения элемента диаграммы. Объект HitTestResult также предоставляет экземпляр выбранного фактического объекта, если таковой имеется.
HitTest(Int32, Int32, Boolean, ChartElementType[])
Определяет, находится ли элемент диаграммы, который является одним из указанных типов, в точке, определенной заданными координатами X и Y.
public:
cli::array <System::Web::UI::DataVisualization::Charting::HitTestResult ^> ^ HitTest(int x, int y, bool ignoreTransparent, ... cli::array <System::Web::UI::DataVisualization::Charting::ChartElementType> ^ requestedElement);
public System.Web.UI.DataVisualization.Charting.HitTestResult[] HitTest(int x, int y, bool ignoreTransparent, params System.Web.UI.DataVisualization.Charting.ChartElementType[] requestedElement);
member this.HitTest : int * int * bool * System.Web.UI.DataVisualization.Charting.ChartElementType[] -> System.Web.UI.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
Флаг, указывающий, что прозрачные элементы должны игнорироваться.
- requestedElement
- ChartElementType[]
Массив объектов, указывающих ChartElementType типы для тестирования, чтобы отфильтровать результат. Если опущено, проверка типов элементов будет игнорироваться, и все типы элементов будут допустимы.
Возвращаемое значение
Массив HitTestResult объектов, предоставляющий сведения об элементе диаграммы( если таковой есть), найденный в указанном расположении. Массив содержит по крайней мере один элемент, который может быть Nothing. Объекты в результате отсортированы от верхней до нижней части различных слоев элемента управления.
Комментарии
Вызовите этот метод, чтобы определить элемент датчика, если он есть, который находится в указанной точке. Этот метод часто используется в некоторых событиях, связанных с мышью, например MouseDown, чтобы определить, какой элемент датчика щелкнул конечный пользователь. Координаты мыши X и Y, полученные из параметров события, затем используются для значений параметров X и Y этого вызова метода.
Затем свойства возвращаемого HitTestResult объекта можно использовать для определения элемента диаграммы. Объект HitTestResult также предоставляет экземпляр выбранного фактического объекта, если таковой имеется.
Применяется к
HitTest(Int32, Int32, ChartElementType)
Определяет, находится ли элемент диаграммы заданного типа в точке, определенной заданными координатами X и Y.
public:
System::Web::UI::DataVisualization::Charting::HitTestResult ^ HitTest(int x, int y, System::Web::UI::DataVisualization::Charting::ChartElementType requestedElement);
public System.Web.UI.DataVisualization.Charting.HitTestResult HitTest(int x, int y, System.Web.UI.DataVisualization.Charting.ChartElementType requestedElement);
member this.HitTest : int * int * System.Web.UI.DataVisualization.Charting.ChartElementType -> System.Web.UI.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 Объект, предоставляющий сведения об элементе диаграммы, если он есть, найден в указанном расположении.
Комментарии
Вызовите этот метод, чтобы определить, находится ли элемент диаграммы заданного типа в указанной точке.
Это важно
Чтобы этот метод работал правильно, IsMapEnabled свойство должно иметь значение false.
Этот метод можно использовать с событием на стороне Click сервера при реализации детализации. Однако настоятельно рекомендуется использовать карты изображений на стороне клиента для детализации из-за простоты использования.
Затем свойства возвращаемого HitTestResult объекта можно использовать для определения элемента диаграммы. Объект HitTestResult также предоставляет экземпляр выбранного фактического объекта, если таковой имеется.
Применяется к
HitTest(Int32, Int32)
Определяет элемент диаграммы( если таковой есть), расположенный в точке, определенной заданными координатами X и Y.
public:
System::Web::UI::DataVisualization::Charting::HitTestResult ^ HitTest(int x, int y);
public System.Web.UI.DataVisualization.Charting.HitTestResult HitTest(int x, int y);
member this.HitTest : int * int -> System.Web.UI.DataVisualization.Charting.HitTestResult
Public Function HitTest (x As Integer, y As Integer) As HitTestResult
Параметры
- x
- Int32
Значение координат X точки, щелкнув пользователя.
- y
- Int32
Значение координат Y точки, щелкнув пользователя.
Возвращаемое значение
HitTestResult Объект, предоставляющий сведения об элементе диаграммы, если таковой имеется, то есть в указанном расположении.
Комментарии
Вызовите этот метод, чтобы определить элемент диаграммы, если таковой находится в указанной точке.
Это важно
Чтобы этот метод работал правильно, IsMapEnabled свойство должно иметь значение false.
Этот метод можно использовать с событием на стороне Click сервера при реализации детализации. Однако настоятельно рекомендуется использовать карты изображений на стороне клиента для детализации из-за простоты использования.
Затем свойства возвращаемого HitTestResult объекта можно использовать для определения элемента диаграммы. Объект HitTestResult также предоставляет экземпляр выбранного фактического объекта, если таковой имеется.
Применяется к
HitTest(Int32, Int32, Boolean)
Определяет элемент диаграммы( если таковой имеется), расположенный в точке, определенной заданными координатами X и Y. Прозрачные элементы можно игнорировать при необходимости.
public:
System::Web::UI::DataVisualization::Charting::HitTestResult ^ HitTest(int x, int y, bool ignoreTransparent);
public System.Web.UI.DataVisualization.Charting.HitTestResult HitTest(int x, int y, bool ignoreTransparent);
member this.HitTest : int * int * bool -> System.Web.UI.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
Флаг, определяющий, игнорируются ли прозрачные элементы.
Возвращаемое значение
HitTestResult Объект, предоставляющий сведения об элементе диаграммы, если таковой имеется, то есть в указанном расположении.
Комментарии
Вызовите этот метод, чтобы определить элемент диаграммы, если таковой находится в указанной точке.
Чтобы игнорировать прозрачные элементы, задайте ignoreTransparent для параметра значение true.
Это важно
Чтобы этот метод работал правильно, IsMapEnabled свойство должно иметь значение false.
Этот метод можно использовать с событием на стороне Click сервера при реализации детализации. Однако настоятельно рекомендуется использовать карты изображений на стороне клиента для детализации из-за простоты использования.
Затем свойства возвращаемого HitTestResult объекта можно использовать для определения элемента диаграммы. Объект HitTestResult также предоставляет экземпляр выбранного фактического объекта, если таковой имеется.