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ý je umístěn v bodě definovaném danými souřadnicemi X a Y.

Přetížení

HitTest(Int32, Int32)	Určuje prvek grafu, pokud existuje, který je umístěn 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 lze 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řadnicemi 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ý je umístěn v zadaném bodě.

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

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

HitTest(Int32, Int32)

Určuje prvek grafu, pokud existuje, který je umístěn 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 klikl.

y

Int32

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

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ý je umístěn v zadaném bodě.

Vlastnosti vráceného objektu HitTestResult lze použít k určení, na který prvek grafu byl klikl; objekt HitTestResult 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 lze 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 klikl.

y

Int32

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

ignoreTransparent

Boolean

true ignorovat průhledné prvky; jinak false.

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ý je umístěn v zadaném bodě.

Pokud chcete ignorovat průhledné prvky, nastavte parametr ignoreTransparent na true.

Vlastnosti vráceného objektu HitTestResult lze použít k určení, na který prvek grafu byl klikl; objekt HitTestResult 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řadnicemi 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 klikl.

y

Int32

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

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 klikl; objekt HitTestResult 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; jinak false.

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ů prvků ignorována a všechny typy prvků budou platné.

Návraty

HitTestResult[]

Pole HitTestResult objektů, které poskytují informace o prvku grafu( pokud existuje) v zadaném umístění. Pole obsahuje alespoň jeden prvek, který může být Nothing. Objekty ve výsledku se seřadí shora dolů od 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ší, například OnMouseDown, k určení prvku měřidla, na který koncový uživatel klikl. Souřadnice myši X a Y získané z parametrů události se pak použijí pro hodnoty parametrů X a Y volání této metody.

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