Chart.HitTest Methode

Definition

Namespace:

System.Web.UI.DataVisualization.Charting

Assembly:

System.Web.DataVisualization.dll

Bestimmt ggf. das Diagrammelement, das sich an einem von der angegebenen x-Koordinate und y-Koordinate definierten Punkt befindet.

Überlädt

HitTest(Int32, Int32, Boolean, ChartElementType[])	Bestimmt, ob sich ein Diagrammelement, bei dem es sich um einen der angegebenen Typen handelt, an einem von den angegebenen X- und Y-Koordinaten definierten Punkt befindet.
HitTest(Int32, Int32, ChartElementType)	Bestimmt, ob sich ein Diagrammelement eines angegebenen Typs an einem von der angegebenen x- und y-Koordinate definierten Punkt befindet.
HitTest(Int32, Int32)	Bestimmt ggf. das Diagrammelement, das sich an einem von der angegebenen x-Koordinate und y-Koordinate definierten Punkt befindet.
HitTest(Int32, Int32, Boolean)	Bestimmt ggf. das Diagrammelement, das sich an einem von der angegebenen x-Koordinate und y-Koordinate definierten Punkt befindet. Transparente Elemente können optional ignoriert werden.

Hinweise

Rufen Sie diese Methode auf, um ggf. das Diagrammelement zu bestimmen, das sich an einem angegebenen Punkt befindet.

Diese Methode wird häufig in einem mausbezogenen Ereignis ( z. B. MouseDown) verwendet, um zu bestimmen, auf welches Diagrammelement der Endbenutzer geklickt hat. Die aus den Ereignisparametern abgerufenen X- und Y-Mauskoordinaten werden dann für die x Parameterwerte und y dieses Methodenaufrufs verwendet.

Die Eigenschaften des zurückgegebenen HitTestResult Objekts können dann verwendet werden, um zu bestimmen, auf welches Diagrammelement geklickt wurde. Das HitTestResult Objekt stellt auch eine instance des tatsächlich ausgewählten Objekts bereit, falls vorhanden.

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

Bestimmt, ob sich ein Diagrammelement, bei dem es sich um einen der angegebenen Typen handelt, an einem von den angegebenen X- und Y-Koordinaten definierten Punkt befindet.

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()

Parameter

x

Int32

Die X-Koordinate für den angegebenen Datenpunkt.

y

Int32

Die Y-Koordinate für den angegebenen Datenpunkt.

ignoreTransparent

Boolean

Ein Flag, das angibt, dass transparente Elemente ignoriert werden sollen.

requestedElement

ChartElementType[]

Ein Array aus ChartElementType-Objekten, die die zu testenden Typen angeben, um das Ergebnis zu filtern. Wenn dies nicht angegeben wird, wird die Überprüfung von Elementtypen ignoriert und alle Elementtypen sind gültig.

Gibt zurück

HitTestResult[]

Ein Array aus HitTestResult-Objekten, die Informationen über das Diagrammelement bereitstellen, sofern ein solches Element an der angegebenen Position gefunden wird. Das Array enthält mindestens ein Element, das Nothing sein kann. Die Objekte im Ergebnis werden hinsichtlich der verschiedenen Steuerungsebenen von oben nach unten sortiert.

Hinweise

Rufen Sie diese Methode auf, um ggf. das Messgerätelement zu bestimmen, das sich an einem angegebenen Punkt befindet. Diese Methode wird häufig in einem mausbezogenen Ereignis verwendet, z. B. MouseDown, um zu bestimmen, auf welches Messgerätelement der Endbenutzer geklickt hat. Die aus den Ereignisparametern abgerufenen X- und Y-Mauskoordinaten werden dann für die X- und Y-Parameterwerte dieses Methodenaufrufs verwendet.

Die Eigenschaften des zurückgegebenen HitTestResult Objekts können dann verwendet werden, um zu bestimmen, auf welches Diagrammelement geklickt wurde. Das HitTestResult Objekt stellt auch eine instance des tatsächlich ausgewählten Objekts bereit, falls vorhanden.

HitTest(Int32, Int32, ChartElementType)

Bestimmt, ob sich ein Diagrammelement eines angegebenen Typs an einem von der angegebenen x- und y-Koordinate definierten Punkt befindet.

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

Parameter

x

Int32

Der x-Koordinatenwert des Punkts, auf den der Benutzer geklickt hat.

y

Int32

Der y-Koordinatenwert des Punkts, auf den der Benutzer geklickt hat.

requestedElement

ChartElementType

Ein Flag, das den zu überprüfenden Diagrammelementtyp bestimmt.

Gibt zurück

HitTestResult

Ein HitTestResult-Objekt, das ggf. Informationen zu dem an der angegebenen Position gefundenen Diagrammelement bereitstellt.

Hinweise

Rufen Sie diese Methode auf, um zu bestimmen, ob sich ein Diagrammelement des angegebenen Typs an einem angegebenen Punkt befindet.

Wichtig

Damit diese Methode ordnungsgemäß funktioniert, muss die IsMapEnabled -Eigenschaft auf falsefestgelegt werden.

Diese Methode kann mit dem Click serverseitigen Ereignis verwendet werden, wenn Sie einen Drilldown implementieren. Es wird jedoch dringend empfohlen, clientseitige Bildzuordnungen für Drilldowns zu verwenden, da sie einfach zu bedienen sind.

Die Eigenschaften des zurückgegebenen HitTestResult Objekts können dann verwendet werden, um zu bestimmen, auf welches Diagrammelement geklickt wurde. Das HitTestResult Objekt stellt auch eine instance des tatsächlich ausgewählten Objekts bereit, falls vorhanden.

HitTest(Int32, Int32)

Bestimmt ggf. das Diagrammelement, das sich an einem von der angegebenen x-Koordinate und y-Koordinate definierten Punkt befindet.

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

Parameter

x

Int32

Der x-Koordinatenwert des Punkts, auf den der Benutzer geklickt hat.

y

Int32

Der y-Koordinatenwert des Punkts, auf den der Benutzer geklickt hat.

Gibt zurück

HitTestResult

Ein HitTestResult-Objekt, das ggf. Informationen zum Diagrammelement am angegebenen Ort bereitstellt.

Hinweise

Rufen Sie diese Methode auf, um ggf. das Diagrammelement zu bestimmen, das sich an einem angegebenen Punkt befindet.

Wichtig

Damit diese Methode ordnungsgemäß funktioniert, muss die IsMapEnabled -Eigenschaft auf falsefestgelegt werden.

Diese Methode kann mit dem Click serverseitigen Ereignis verwendet werden, wenn Sie einen Drilldown implementieren. Es wird jedoch dringend empfohlen, clientseitige Bildzuordnungen für Drilldowns zu verwenden, da sie einfach zu bedienen sind.

Die Eigenschaften des zurückgegebenen HitTestResult Objekts können dann verwendet werden, um zu bestimmen, auf welches Diagrammelement geklickt wurde. Das HitTestResult Objekt stellt auch eine instance des tatsächlich ausgewählten Objekts bereit, falls vorhanden.

HitTest(Int32, Int32, Boolean)

Bestimmt ggf. das Diagrammelement, das sich an einem von der angegebenen x-Koordinate und y-Koordinate definierten Punkt befindet. Transparente Elemente können optional ignoriert werden.

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

Parameter

x

Int32

Der x-Koordinatenwert des Punkts, auf den der Benutzer geklickt hat.

y

Int32

Der y-Koordinatenwert des Punkts, auf den der Benutzer geklickt hat.

ignoreTransparent

Boolean

Ein Flag, das bestimmt, ob transparente Elemente ignoriert werden.

Gibt zurück

HitTestResult

Ein HitTestResult-Objekt, das ggf. Informationen zum Diagrammelement am angegebenen Ort bereitstellt.

Hinweise

Rufen Sie diese Methode auf, um ggf. das Diagrammelement zu bestimmen, das sich an einem angegebenen Punkt befindet.

Um transparente Elemente zu ignorieren, legen Sie den ignoreTransparent Parameter auf fest true.

Wichtig

Damit diese Methode ordnungsgemäß funktioniert, muss die IsMapEnabled -Eigenschaft auf falsefestgelegt werden.

Diese Methode kann mit dem Click serverseitigen Ereignis verwendet werden, wenn Sie einen Drilldown implementieren. Es wird jedoch dringend empfohlen, clientseitige Bildzuordnungen für Drilldowns zu verwenden, da sie einfach zu bedienen sind.

Die Eigenschaften des zurückgegebenen HitTestResult Objekts können dann verwendet werden, um zu bestimmen, auf welches Diagrammelement geklickt wurde. Das HitTestResult Objekt stellt auch eine instance des tatsächlich ausgewählten Objekts bereit, falls vorhanden.