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 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 HitTestResult zwracanego 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::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 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.

Właściwości HitTestResult zwracanego 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::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, na który kliknął użytkownik.

y

Int32

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

ignoreTransparent

Boolean

true ignorować przezroczyste elementy; w przeciwnym razie , false.

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.

Właściwości HitTestResult zwracanego 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::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, 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 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 HitTestResult zwracanego 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::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 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 , OnMouseDownw celu określenia elementu miernika 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 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.