Chart.HitTest Metoda
Definice
Důležité
Některé informace platí pro předběžně vydaný produkt, který se může zásadně změnit, než ho výrobce nebo autor vydá. Microsoft neposkytuje žádné záruky, výslovné ani předpokládané, týkající se zde uváděných informací.
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
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.
Platí pro
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; false
v opačném případě .
Návraty
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.
Platí pro
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
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.
Platí pro
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; false
v 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
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.