Chart.HitTest Metoda

Definice

Obor názvů:

System.Windows.Forms.DataVisualization.Charting

Sestavení:

System.Windows.Forms.DataVisualization.dll

Určuje prvek grafu, pokud existuje, který se nachází v bodě definovaném danými souřadnicemi X a Y.

Přetížení

HitTest(Int32, Int32)	Určuje prvek grafu, pokud existuje, který se nachází v bodě definovaném danými souřadnicemi X a Y.
HitTest(Int32, Int32, Boolean)	Určuje prvek grafu, pokud existuje, který se nachází v bodě definovaném danými souřadnicemi X a Y. Průhledné prvky je možné volitelně ignorovat.
HitTest(Int32, Int32, ChartElementType)	Určuje, zda je prvek grafu daného typu umístěn v bodě definovaném daným souřadnicem X a Y.
HitTest(Int32, Int32, Boolean, ChartElementType[])	Určuje, zda je prvek grafu, který je jedním ze zadaných typů, umístěn v bodě definovaném danými souřadnicemi X a Y.

Poznámky

Voláním této metody určíte prvek grafu, pokud existuje, který se nachází v zadaném bodě.

Tato metoda se často používá v určité události související s myší – například – k určení prvku grafu, OnMouseDown na který koncový uživatel kliknul. Souřadnice myši X a Y získané z parametrů události se pak používají pro x hodnoty parametrů této metody a y hodnoty parametrů tohoto volání metody.

Vlastnosti vráceného objektu HitTestResult lze použít k určení, na který prvek grafu byl kliknut; HitTestResult objekt také poskytuje instanci skutečného objektu vybraného, pokud existuje.

HitTest(Int32, Int32)

Určuje prvek grafu, pokud existuje, který se nachází v bodě definovaném danými souřadnicemi X a 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

Hodnota souřadnic X bodu, na který uživatel kliknul.

y

Int32

Hodnota souřadnice Y bodu, na který uživatel kliknul.

Návraty

HitTestResult

Objekt HitTestResult , který poskytuje informace o prvku grafu, pokud existuje, který je v zadaném umístění.

Poznámky

Voláním této metody určíte prvek grafu, pokud existuje, který se nachází v zadaném bodě.

Vlastnosti vráceného objektu HitTestResult lze použít k určení, na který prvek grafu byl kliknut; HitTestResult objekt také poskytuje instanci skutečného objektu vybraného, pokud existuje.

HitTest(Int32, Int32, Boolean)

Určuje prvek grafu, pokud existuje, který se nachází v bodě definovaném danými souřadnicemi X a Y. Průhledné prvky je možné volitelně ignorovat.

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

Hodnota souřadnic X bodu, na který uživatel kliknul.

y

Int32

Hodnota souřadnice Y bodu, na který uživatel kliknul.

ignoreTransparent

Boolean

true ignorovat průhledné prvky; falsev opačném případě .

Návraty

HitTestResult

Objekt HitTestResult , který poskytuje informace o prvku grafu, pokud existuje, který je v zadaném umístění.

Poznámky

Voláním této metody určíte prvek grafu, pokud existuje, který se nachází v zadaném bodě.

Chcete-li ignorovat průhledné prvky, nastavte ignoreTransparent parametr na true.

Vlastnosti vráceného objektu HitTestResult lze použít k určení, na který prvek grafu byl kliknut; HitTestResult objekt také poskytuje instanci skutečného objektu vybraného, pokud existuje.

HitTest(Int32, Int32, ChartElementType)

Určuje, zda je prvek grafu daného typu umístěn v bodě definovaném daným souřadnicem X a 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

Hodnota souřadnic X bodu, na který uživatel kliknul.

y

Int32

Hodnota souřadnice Y bodu, na který uživatel kliknul.

requestedElement

ChartElementType

Příznak, který určuje typ prvku grafu, který se má testovat.

Návraty

HitTestResult

Objekt HitTestResult , který poskytuje informace o prvku grafu, pokud existuje, který je v zadaném umístění.

Poznámky

Voláním této metody určíte, zda je prvek grafu daného typu umístěn v zadaném bodě.

Vlastnosti vráceného objektu HitTestResult lze použít k určení, na který prvek grafu byl kliknut; HitTestResult objekt také poskytuje instanci skutečného objektu vybraného, pokud existuje.

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

Určuje, zda je prvek grafu, který je jedním ze zadaných typů, umístěn v bodě definovaném danými souřadnicemi X a 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

Souřadnice X pro zadaný datový bod.

y

Int32

Souřadnice Y pro zadaný datový bod.

ignoreTransparent

Boolean

true ignorovat průhledné prvky; falsev opačném případě .

requestedElement

ChartElementType[]

Pole ChartElementType objektů, které určují typy, pro které se mají testovat, aby bylo možné filtrovat výsledek. Pokud tento argument vynecháte, bude kontrola typů elementů ignorována a všechny typy elementů budou platné.

Návraty

HitTestResult[]

Pole HitTestResult objektů, které poskytují informace o prvku grafu, pokud existuje, nalezen v zadaném umístění. Pole obsahuje alespoň jeden prvek, který může být Nothing. Objekty ve výsledku jsou seřazené od horního po dolní části různých vrstev ovládacího prvku.

Poznámky

Voláním této metody určíte prvek měřidla, pokud existuje, který je umístěn v zadaném bodě. Tato metoda se často používá v některých událostech souvisejících s myší, OnMouseDownnapříklad k určení prvku měřidla, na který koncový uživatel kliknul. Souřadnice myši X a Y získané z parametrů události se pak používají pro hodnoty parametrů X a Y volání této metody.

Vlastnosti vráceného HitTestResult objektu lze pak použít k určení prvku grafu, na který byl kliknut; HitTestResult objekt také poskytuje instanci skutečného objektu, pokud existuje.