Chart.HitTest Metoda

Definicja

Przestrzeń nazw:

System.Web.UI.DataVisualization.Charting

Zestaw:

System.Web.DataVisualization.dll

Określa element wykresu, jeśli istnieje, który znajduje się w punkcie zdefiniowanym przez podane współrzędne X i Y.

Przeciążenia

HitTest(Int32, Int32, Boolean, ChartElementType[])	Określa, czy element wykresu, który jest jednym z określonych typów, znajduje się w punkcie zdefiniowanym przez podane współrzędne X i Y.
HitTest(Int32, Int32, ChartElementType)	Określa, czy element wykresu danego typu znajduje się w punkcie zdefiniowanym przez podane współrzędne X i Y.
HitTest(Int32, Int32)	Określa element wykresu, jeśli istnieje, który znajduje się w punkcie zdefiniowanym przez podane współrzędne X i Y.
HitTest(Int32, Int32, Boolean)	Określa element wykresu, jeśli istnieje, który znajduje się w punkcie zdefiniowanym przez podane współrzędne X i Y. Elementy przezroczyste można opcjonalnie zignorować.

Uwagi

Wywołaj tę metodę, aby określić element wykresu, jeśli istnieje, który znajduje się w określonym punkcie.

Ta metoda jest często używana w niektórych zdarzeniach związanych z myszą — na przykład MouseDown — w celu określenia elementu wykresu klikniętego przez użytkownika końcowego. Współrzędne myszy X i Y uzyskane z parametrów zdarzenia są następnie używane dla x wartości parametrów i y tego wywołania metody.

Właściwości zwróconego HitTestResult obiektu można następnie użyć do określenia, który element wykresu został kliknięty. HitTestResult Obiekt udostępnia również wystąpienie rzeczywistego obiektu wybranego, jeśli istnieje.

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

Określa, czy element wykresu, który jest jednym z określonych typów, znajduje się w punkcie zdefiniowanym przez podane współrzędne X i 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()

Parametry

x

Int32

Współrzędna X dla określonego punktu danych.

y

Int32

Współrzędna Y dla określonego punktu danych.

ignoreTransparent

Boolean

Flaga wskazująca, że przezroczyste elementy powinny być ignorowane.

requestedElement

ChartElementType[]

Tablica obiektów określających ChartElementType typy do przetestowania, aby filtrować wynik. Jeśli pominięto, sprawdzanie typów elementów zostanie zignorowane, a wszystkie typy elementów będą prawidłowe.

Zwraca

HitTestResult[]

Tablica HitTestResult obiektów, która zawiera informacje o elemecie chart, jeśli istnieje, znalezione w określonej lokalizacji. Tablica zawiera co najmniej jeden element, który może być Nothing. Obiekty w wyniku są sortowane od góry do dołu różnych warstw kontrolki.

Uwagi

Wywołaj tę metodę, aby określić element miernika, jeśli istnieje, który znajduje się w określonym punkcie. Ta metoda jest często używana w niektórych zdarzeniach związanych z myszą, na przykład MouseDown, aby określić, który element miernika kliknął użytkownik końcowy. Współrzędne myszy X i Y uzyskane z parametrów zdarzenia są następnie używane dla wartości parametrów X i Y tego wywołania metody.

Właściwości zwróconego HitTestResult obiektu można następnie użyć do określenia, który element wykresu został kliknięty. HitTestResult Obiekt udostępnia również wystąpienie rzeczywistego obiektu wybranego, jeśli istnieje.

HitTest(Int32, Int32, ChartElementType)

Określa, czy element wykresu danego typu znajduje się w punkcie zdefiniowanym przez podane współrzędne X i 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

Parametry

x

Int32

Wartość współrzędnych X punktu, na który kliknął użytkownik.

y

Int32

Wartość współrzędnych Y punktu, który kliknął użytkownik.

requestedElement

ChartElementType

Flaga określająca typ elementu wykresu do przetestowania.

Zwraca

HitTestResult

HitTestResult Obiekt, który zawiera informacje o elemecie chart, jeśli istnieje, znaleziony w określonej lokalizacji.

Uwagi

Wywołaj tę metodę, aby określić, czy element wykresu danego typu znajduje się w określonym punkcie.

Ważne

Aby ta metoda działała poprawnie, właściwość musi być ustawiona IsMapEnabled na false.

Ta metoda może być używana z zdarzeniem Click po stronie serwera podczas implementowania przechodzenia do szczegółów. Zdecydowanie zaleca się jednak używanie map obrazów po stronie klienta do przechodzenia do szczegółów ze względu na łatwość użycia.

Właściwości zwróconego HitTestResult obiektu można następnie użyć do określenia, który element wykresu został kliknięty. HitTestResult Obiekt udostępnia również wystąpienie rzeczywistego obiektu wybranego, jeśli istnieje.

HitTest(Int32, Int32)

Określa element wykresu, jeśli istnieje, który znajduje się w punkcie zdefiniowanym przez podane współrzędne X i 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

Parametry

x

Int32

Wartość współrzędnych X punktu, który kliknął użytkownik.

y

Int32

Wartość współrzędnych Y punktu, który kliknął użytkownik.

Zwraca

HitTestResult

HitTestResult Obiekt, który zawiera informacje dotyczące elementu wykresu, jeśli istnieje, znajduje się w określonej lokalizacji.

Uwagi

Wywołaj tę metodę, aby określić element wykresu, jeśli istnieje, który znajduje się w określonym punkcie.

Ważne

Aby ta metoda działała poprawnie, właściwość musi być ustawiona IsMapEnabled na false.

Ta metoda może być używana z zdarzeniem Click po stronie serwera podczas implementowania przechodzenia do szczegółów. Zdecydowanie zaleca się jednak używanie map obrazów po stronie klienta do przechodzenia do szczegółów ze względu na łatwość użycia.

Właściwości zwróconego HitTestResult obiektu można następnie użyć do określenia, który element wykresu został kliknięty. HitTestResult Obiekt udostępnia również wystąpienie rzeczywistego obiektu wybranego, jeśli istnieje.

HitTest(Int32, Int32, Boolean)

Określa element wykresu, jeśli istnieje, który znajduje się w punkcie zdefiniowanym przez podane współrzędne X i Y. Elementy przezroczyste można opcjonalnie zignorować.

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

Parametry

x

Int32

Wartość współrzędnych X punktu, na który kliknął użytkownik.

y

Int32

Wartość współrzędnych Y punktu, który kliknął użytkownik.

ignoreTransparent

Boolean

Flaga określająca, czy elementy przezroczyste są ignorowane.

Zwraca

HitTestResult

HitTestResult Obiekt, który zawiera informacje dotyczące elementu wykresu, jeśli istnieje, znajduje się w określonej lokalizacji.

Uwagi

Wywołaj tę metodę, aby określić element wykresu, jeśli istnieje, który znajduje się w określonym punkcie.

Aby zignorować przezroczyste elementy, ustaw ignoreTransparent parametr na true.

Ważne

Aby ta metoda działała poprawnie, właściwość musi być ustawiona IsMapEnabled na false.

Ta metoda może być używana z zdarzeniem Click po stronie serwera podczas implementowania przechodzenia do szczegółów. Zdecydowanie zaleca się jednak używanie map obrazów po stronie klienta do przechodzenia do szczegółów ze względu na łatwość użycia.

Właściwości zwróconego HitTestResult obiektu można następnie użyć do określenia, który element wykresu został kliknięty. HitTestResult Obiekt udostępnia również wystąpienie rzeczywistego obiektu wybranego, jeśli istnieje.