Chart.HitTest Metoda

Definicja

Przestrzeń nazw:

System.Windows.Forms.DataVisualization.Charting

Zestaw:

System.Windows.Forms.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)	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ć.
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, 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.

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 OnMouseDown — w celu określenia elementu wykresu, który użytkownik końcowy kliknął. Współrzędne myszy X i Y uzyskane z parametrów zdarzenia są następnie używane dla x i y wartości parametrów tego wywołania metody.

Właściwości zwracanego obiektu HitTestResult można następnie użyć do określenia, który element wykresu został kliknięty; obiekt HitTestResult 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::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

Parametry

x

Int32

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

y

Int32

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

Zwraca

HitTestResult

Obiekt HitTestResult, 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.

Właściwości zwracanego obiektu HitTestResult można następnie użyć do określenia, który element wykresu został kliknięty; obiekt HitTestResult 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::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

Parametry

x

Int32

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

y

Int32

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

ignoreTransparent

Boolean

true ignorować przezroczyste elementy; w przeciwnym razie false.

Zwraca

HitTestResult

Obiekt HitTestResult, 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 parametr ignoreTransparent na wartość true.

Właściwości zwracanego obiektu HitTestResult można następnie użyć do określenia, który element wykresu został kliknięty; obiekt HitTestResult 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::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

Parametry

x

Int32

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

y

Int32

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

requestedElement

ChartElementType

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

Zwraca

HitTestResult

Obiekt HitTestResult, 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ć, czy element wykresu danego typu znajduje się w określonym punkcie.

Właściwości zwracanego obiektu HitTestResult można następnie użyć do określenia, który element wykresu został kliknięty; obiekt HitTestResult 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::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()

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

true ignorować przezroczyste elementy; w przeciwnym razie false.

requestedElement

ChartElementType[]

Tablica obiektów ChartElementType, które określają typy do przetestowania, w celu filtrowania wyniku. Jeśli pominięto, sprawdzanie typów elementów zostanie zignorowane, a wszystkie typy elementów będą prawidłowe.

Zwraca

HitTestResult[]

Tablica obiektów HitTestResult, które zawierają informacje na temat elementu wykresu, 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 OnMouseDown, aby określić element miernika klikniętego przez użytkownika końcowego. Współrzędne X i Y myszy 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 obiektu HitTestResult można następnie użyć do określenia, który element wykresu został kliknięty; obiekt HitTestResult udostępnia również wystąpienie rzeczywistego obiektu wybranego, jeśli istnieje.