Chart.HitTest Метод

Определение

Пространство имен:

System.Web.UI.DataVisualization.Charting

Сборка:

System.Web.DataVisualization.dll

Определяет элемент диаграммы, если таковой существует, расположенный в точке, которая определяется заданными координатами 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[]

Массив объектов 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

Объект 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

Объект 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

Объект HitTestResult, содержащий информацию об элементе диаграммы, если таковой существует, который находится в указанном местоположении.

Комментарии

Вызовите этот метод, чтобы определить элемент диаграммы , если он есть, который находится в указанной точке.

Чтобы игнорировать прозрачные ignoreTransparent элементы, задайте для параметра значение true.

Важно!

Чтобы этот метод работал правильно, свойству IsMapEnabled необходимо задать значение false.

Этот метод можно использовать с событием на стороне Click сервера при реализации детализации. Однако настоятельно рекомендуется использовать клиентские карты изображений для детализации из-за простоты использования.

Затем свойства возвращаемого HitTestResult объекта можно использовать для определения того, какой элемент диаграммы был нажат. HitTestResult Объект также предоставляет экземпляр фактического выбранного объекта, если таковой имеется.