Chart.HitTest Metoda

Definice

Obor názvů:

System.Web.UI.DataVisualization.Charting

Sestavení:

System.Web.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í

Name	Description
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.
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ý 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.

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 MouseDown – 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 hodnoty parametrů této metody a y hodnoty parametrů tohoto volání metody.

Vlastnosti vráceného HitTestResult objektu lze pak 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::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 průhledné 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 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 MouseDown, 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 pak 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ý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, 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 Click lze použít s událostí na straně serveru při implementaci přechodu k podrobnostem. Důrazně se ale doporučuje používat mapy obrázků na straně klienta pro přechod k podrobnostem kvůli snadnému použití.

Vlastnosti vráceného HitTestResult objektu lze pak 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ý je 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);

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 o prvku grafu, pokud existuje, 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ě.

Důležité

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

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

Vlastnosti vráceného HitTestResult objektu lze pak 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 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 průhledné prvky ignorovány.

Návraty

HitTestResult

Objekt HitTestResult , který poskytuje informace o prvku grafu, pokud existuje, 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 ignoreTransparent parametr na truehodnotu .

Důležité

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

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

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