Chart.HitTest Metoda

Definice

Obor názvů:

System.Web.UI.DataVisualization.Charting

Sestavení:

System.Web.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, Boolean, ChartElementType[])	Určuje, zda se prvek grafu, který je jedním ze zadaných typů, nachází v bodě definovaném danými souřadnicemi X a Y.
HitTest(Int32, Int32, ChartElementType)	Určuje, zda je prvek grafu daného typu umístěn v bodě definovaném danými souřadnicemi X a Y.
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 lze volitelně ignorovat.

Poznámky

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

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

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

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

Určuje, zda se prvek grafu, který je jedním ze zadaných typů, nachází v bodě definovaném danými souřadnicemi X a Y.

public:
 cli::array <System::Web::UI::DataVisualization::Charting::HitTestResult ^> ^ HitTest(int x, int y, bool ignoreTransparent, ... cli::array <System::Web::UI::DataVisualization::Charting::ChartElementType> ^ requestedElement);

public System.Web.UI.DataVisualization.Charting.HitTestResult[] HitTest (int x, int y, bool ignoreTransparent, params System.Web.UI.DataVisualization.Charting.ChartElementType[] requestedElement);

member this.HitTest : int * int * bool * System.Web.UI.DataVisualization.Charting.ChartElementType[] -> System.Web.UI.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

Příznak, který označuje, že transparentní prvky by měly být ignorovány.

requestedElement

ChartElementType[]

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

Návraty

HitTestResult[]

Pole HitTestResult objektů, které poskytuje informace o prvku grafu, pokud existuje, který se nachází v zadaném umístění. Pole obsahuje alespoň jeden prvek, kterým může být Nothing. Objekty ve výsledku jsou seřazené odshora dolů od různých vrstev ovládacích prvků.

Poznámky

Voláním této metody určíte prvek měřidla, pokud existuje, který se nachází v zadaném bodě. Tato metoda se často používá v některých událostech souvisejících s myší, například MouseDown, k určení prvku měřidla, na který 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 pak použít k určení, na který prvek grafu byl klikl HitTestResult ; objekt také poskytuje instanci skutečného vybraného objektu, pokud existuje.

HitTest(Int32, Int32, ChartElementType)

Určuje, zda je prvek grafu daného typu umístěn v bodě definovaném danými souřadnicemi X a Y.

public:
 System::Web::UI::DataVisualization::Charting::HitTestResult ^ HitTest(int x, int y, System::Web::UI::DataVisualization::Charting::ChartElementType requestedElement);

public System.Web.UI.DataVisualization.Charting.HitTestResult HitTest (int x, int y, System.Web.UI.DataVisualization.Charting.ChartElementType requestedElement);

member this.HitTest : int * int * System.Web.UI.DataVisualization.Charting.ChartElementType -> System.Web.UI.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, nalezen 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ě.

Důležité

Aby tato metoda fungovala správně, IsMapEnabled musí být vlastnost nastavena na falsehodnotu .

Tuto metodu lze použít s událostí na Click straně serveru při implementaci přechodu k podrobnostem. Kvůli snadnému použití se ale důrazně doporučuje používat mapy obrázků na straně klienta pro přechod k podrobnostem.

Vlastnosti vráceného HitTestResult objektu lze pak použít k určení, na který prvek grafu byl klikl HitTestResult ; objekt také poskytuje instanci skutečného vybraného objektu, 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::Web::UI::DataVisualization::Charting::HitTestResult ^ HitTest(int x, int y);

public System.Web.UI.DataVisualization.Charting.HitTestResult HitTest (int x, int y);

member this.HitTest : int * int -> System.Web.UI.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 týkající se prvku grafu, pokud existuje, který se nachází 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ě.

Důležité

Aby tato metoda fungovala správně, IsMapEnabled musí být vlastnost nastavena na falsehodnotu .

Tuto metodu lze použít s událostí na Click straně serveru při implementaci přechodu k podrobnostem. Kvůli snadnému použití se ale důrazně doporučuje používat mapy obrázků na straně klienta pro přechod k podrobnostem.

Vlastnosti vráceného HitTestResult objektu lze pak použít k určení, na který prvek grafu byl klikl HitTestResult ; objekt také poskytuje instanci skutečného vybraného objektu, 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::Web::UI::DataVisualization::Charting::HitTestResult ^ HitTest(int x, int y, bool ignoreTransparent);

public System.Web.UI.DataVisualization.Charting.HitTestResult HitTest (int x, int y, bool ignoreTransparent);

member this.HitTest : int * int * bool -> System.Web.UI.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

Příznak, který určuje, jestli jsou transparentní prvky ignorovány.

Návraty

HitTestResult

Objekt HitTestResult , který poskytuje informace týkající se prvku grafu, pokud existuje, který se nachází 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ě.

Pokud chcete transparentní prvky ignorovat, nastavte ignoreTransparent parametr na true.

Důležité

Aby tato metoda fungovala správně, IsMapEnabled musí být vlastnost nastavena na falsehodnotu .

Tuto metodu lze použít s událostí na Click straně serveru při implementaci přechodu k podrobnostem. Kvůli snadnému použití se ale důrazně doporučuje používat mapy obrázků na straně klienta pro přechod k podrobnostem.

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