Chart.HitTest Methode

Definition

Namespace:

System.Windows.Forms.DataVisualization.Charting

Assembly:

System.Windows.Forms.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)	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.
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, 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.

Hinweise

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

Diese Methode wird häufig in einigen mausbezogenen Ereignissen verwendet, z OnMouseDown . B. um zu bestimmen, auf welches Diagrammelement der Endbenutzer geklickt hat. Die von den Ereignisparametern abgerufenen X- und Y-Mauskoordinaten werden dann für die x Werte y und Parameterwerte dieses Methodenaufrufs verwendet.

Die Eigenschaften des HitTestResult zurückgegebenen Objekts können dann verwendet werden, um zu ermitteln, auf welches Diagrammelement geklickt wurde; das HitTestResult Objekt stellt auch eine Instanz des ausgewählten tatsächlichen 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::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

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 das Diagrammelement zu bestimmen, falls vorhanden, das sich an einem angegebenen Punkt befindet.

Die Eigenschaften des HitTestResult zurückgegebenen Objekts können dann verwendet werden, um zu ermitteln, auf welches Diagrammelement geklickt wurde; das HitTestResult Objekt stellt auch eine Instanz des ausgewählten tatsächlichen 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::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

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

true, um transparente Elemente zu ignorieren; andernfalls false.

Gibt zurück

HitTestResult

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

Hinweise

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

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

Die Eigenschaften des HitTestResult zurückgegebenen Objekts können dann verwendet werden, um zu ermitteln, auf welches Diagrammelement geklickt wurde; das HitTestResult Objekt stellt auch eine Instanz des ausgewählten tatsächlichen 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::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

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 zum Diagrammelement am angegebenen Ort bereitstellt.

Hinweise

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

Die Eigenschaften des HitTestResult zurückgegebenen Objekts können dann verwendet werden, um zu ermitteln, auf welches Diagrammelement geklickt wurde; das HitTestResult Objekt stellt auch eine Instanz des ausgewählten tatsächlichen 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::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()

Parameter

x

Int32

Die X-Koordinate für den angegebenen Datenpunkt.

y

Int32

Die Y-Koordinate für den angegebenen Datenpunkt.

ignoreTransparent

Boolean

true, um transparente Elemente zu ignorieren; andernfalls false.

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 das Maßelement zu bestimmen, falls vorhanden, das sich an einem angegebenen Punkt befindet. Diese Methode wird häufig in einigen mausbezogenen Ereignissen verwendet, OnMouseDownz. B. zum Ermitteln, auf welches Maßelement der Endbenutzer geklickt hat. Die von den Ereignisparametern abgerufenen X- und Y-Mauskoordinaten werden dann für die X- und Y-Parameterwerte dieses Methodenaufrufs verwendet.

Die Eigenschaften des zurückgegebenen Objekts können dann verwendet werden, um zu ermitteln, auf welches Diagrammelement geklickt wurde; das HitTestResult Objekt stellt auch eine Instanz des ausgewählten tatsächlichen HitTestResult Objekts bereit, falls vorhanden.