Chart.HitTest Methode

Definition

Namespace:

System.Windows.Forms.DataVisualization.Charting

Assembly:

System.Windows.Forms.DataVisualization.dll

Bestimmt das Diagrammelement( falls vorhanden), das sich an einem punkt befindet, der durch die angegebenen X- und Y-Koordinaten definiert ist.

Überlädt

HitTest(Int32, Int32)	Bestimmt das Diagrammelement( falls vorhanden), das sich an einem punkt befindet, der durch die angegebenen X- und Y-Koordinaten definiert ist.
HitTest(Int32, Int32, Boolean)	Bestimmt, falls vorhanden, das Diagrammelement an einem punkt, der durch die angegebenen X- und Y-Koordinaten definiert ist. Transparente Elemente können optional ignoriert werden.
HitTest(Int32, Int32, ChartElementType)	Bestimmt, ob sich ein Diagrammelement eines bestimmten Typs an einem punkt befindet, der durch bestimmte X- und Y-Koordinaten definiert ist.
HitTest(Int32, Int32, Boolean, ChartElementType[])	Bestimmt, ob sich ein Diagrammelement, das einer der angegebenen Typen ist, an einem Punkt befindet, der durch die angegebenen X- und Y-Koordinaten definiert ist.

Hinweise

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

Diese Methode wird häufig in einigen mausbezogenen Ereignissen verwendet, z. B. OnMouseDown, um zu bestimmen, auf welches Diagrammelement der Endbenutzer geklickt hat. Die X- und Y-Mauskoordinaten, die aus den Ereignisparametern abgerufen werden, 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 Instanz des tatsächlich ausgewählten Objekts bereit, falls vorhanden.

HitTest(Int32, Int32)

Bestimmt das Diagrammelement( falls vorhanden), das sich an einem punkt befindet, der durch die angegebenen X- und Y-Koordinaten definiert ist.

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 bereitstellt, das sich an der angegebenen Position befindet.

Hinweise

Rufen Sie diese Methode auf, um das Diagrammelement (sofern vorhanden) zu bestimmen, das sich an einem bestimmten Punkt befindet.

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 Instanz des tatsächlich ausgewählten Objekts bereit, falls vorhanden.

HitTest(Int32, Int32, Boolean)

Bestimmt, falls vorhanden, das Diagrammelement an einem punkt, der durch die angegebenen X- und Y-Koordinaten definiert ist. 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, transparente Elemente zu ignorieren; andernfalls false.

Gibt zurück

HitTestResult

Ein HitTestResult-Objekt, das ggf. Informationen zum Diagrammelement bereitstellt, das sich an der angegebenen Position befindet.

Hinweise

Rufen Sie diese Methode auf, um das Diagrammelement (sofern vorhanden) zu bestimmen, das sich an einem bestimmten Punkt befindet.

Um transparente Elemente zu ignorieren, legen Sie den parameter ignoreTransparent auf truefest.

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 Instanz des tatsächlich ausgewählten Objekts bereit, falls vorhanden.

HitTest(Int32, Int32, ChartElementType)

Bestimmt, ob sich ein Diagrammelement eines bestimmten Typs an einem punkt befindet, der durch bestimmte X- und Y-Koordinaten definiert ist.

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 Kennzeichen, das den zu testden Diagrammelementtyp bestimmt.

Gibt zurück

HitTestResult

Ein HitTestResult-Objekt, das ggf. Informationen zum Diagrammelement bereitstellt, das sich an der angegebenen Position befindet.

Hinweise

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

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 Instanz des tatsächlich ausgewählten Objekts bereit, falls vorhanden.

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

Bestimmt, ob sich ein Diagrammelement, das einer der angegebenen Typen ist, an einem Punkt befindet, der durch die angegebenen X- und Y-Koordinaten definiert ist.

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, transparente Elemente zu ignorieren; andernfalls false.

requestedElement

ChartElementType[]

Ein Array von ChartElementType Objekten, die die zu testende Typen angeben, um das Ergebnis zu filtern. Wird die Überprüfung auf Elementtypen nicht angegeben, werden ignoriert, und alle Elementtypen sind gültig.

Gibt zurück

HitTestResult[]

Ein Array von HitTestResult Objekten, die Informationen über das Diagrammelement (sofern vorhanden) an der angegebenen Position bereitstellt. Das Array enthält mindestens ein Element, das Nothingwerden kann. Die Objekte im Ergebnis werden von oben nach unten in verschiedenen Steuerelementebenen sortiert.

Hinweise

Rufen Sie diese Methode auf, um das Messelement (falls vorhanden) zu bestimmen, das sich an einem bestimmten Punkt befindet. Diese Methode wird häufig in einigen mausbezogenen Ereignissen verwendet, z. B. OnMouseDown, um zu bestimmen, auf welches Maßelement der Endbenutzer geklickt hat. Die X- und Y-Mauskoordinaten, die aus den Ereignisparametern abgerufen werden, 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 Instanz des tatsächlich ausgewählten Objekts bereit, falls vorhanden.