IDataSeries
Definiert die Basisschnittstelle zu einem DataSeries, die eine Datenquelle für BaseRenderableSeries bietet
Implementiert: ISuspendable
Eigenschaften
public bool AcceptsUnsortedData { get; set; }
value = iDataSeries.AcceptsUnsortedData
iDataSeries.AcceptsUnsortedData = value
Neu bei v3.3: Wenn AcceptsUnsortedData falsch ist, dann DataSeries mit einem InvalidOperationException, wenn unsortierte Daten hinzugefügt werden. Ungewollte unsortierte Daten können zu einer viel langsameren Leistung führen.
public int Count { get; }
value = iDataSeries.Count
Bestimmt die Anzahl der Punkte in dieser Datenreihe
public DataSeriesType DataSeriesType { get; }
value = iDataSeries.DataSeriesType
Bekommt die DataSeriesType @ dafür DataSeries
public int? FifoCapacity { get; set; }
value = iDataSeries.FifoCapacity
iDataSeries.FifoCapacity = value
Wenn die Datenreihe unbegrenzt ist, wenn ein Wert gesetzt wird, wenn die Punktzahl diesen Wert erreicht, werden ältere Punkte verworfen.
public bool HasValues { get; }
value = iDataSeries.HasValues
Erhält, ob der DataSeries Werte hat (nicht leer ist)
public bool IsAttached { get; }
value = iDataSeries.IsAttached
Erhaltet, ob der aktuelle DataSeries an einen DataSet angehängt ist
public bool IsFifo { get; }
value = iDataSeries.IsFifo
Wenn es wahr ist, wenn die Datenreihe sich wie ein FIFO verhält, werden alte Punkte zugunsten neuer Punkte verworfen, was zu einem Scrolling-Diagramm führt.
public bool IsSecondary { get; }
value = iDataSeries.IsSecondary
Wenn dies zutrifft, wird diese Datenreihe nicht für die Berechnung des Kartenbereichs ausgewählt.
public bool IsSorted { get; }
value = iDataSeries.IsSorted
Wenn es möglich ist, versuchen Sie, die Daten in X-Richtung zu sortieren.
public IComparable LatestYValue { get; }
value = iDataSeries.LatestYValue
Holt sich den neuesten Y-Wert des DataSeries
public IUltrachartSurface ParentSurface { get; set; }
value = iDataSeries.ParentSurface
iDataSeries.ParentSurface = value
Bekommt oder setzt den übergeordneten IUltrachartSurface, an den diese IDataSeries Instanz angehängt ist
public string SeriesName { get; set; }
value = iDataSeries.SeriesName
iDataSeries.SeriesName = value
Bekommt oder setzt den Namen dieser Serie
public Lock SyncRoot { get; }
value = iDataSeries.SyncRoot
Bekommt ein Synchronisationsobjekt, das zum Sperren dieser Datenserie verwendet wird.
public IComparable XMax { get; }
value = iDataSeries.XMax
Holt den berechneten Maximalwert in X für diese Serie
public IComparable XMin { get; }
value = iDataSeries.XMin
Holt sich den berechneten Mindestwert in X für diese Serie
public IRange XRange { get; }
value = iDataSeries.XRange
Holt sich die Gesamtausdehnungen des IDataSeries in der X-Richtung
public Type XType { get; }
value = iDataSeries.XType
Bekommt den Typ der X-Datenpunkte in diesem DataSeries @. Wird verwendet, um die Kompatibilität mit Achsentypen zu überprüfen
public IList XValues { get; }
value = iDataSeries.XValues
Bekommt die XValues dieser Datenreihe
public IComparable YMax { get; }
value = iDataSeries.YMax
Bekommt den berechneten Maximalwert in Y für diese Serie
public IComparable YMin { get; }
value = iDataSeries.YMin
Bekommt den berechneten Mindestwert in Y für diese Serie
public IRange YRange { get; }
value = iDataSeries.YRange
Holt sich die Gesamtausdehnungen des IDataSeries in der Y-Richtung
public Type YType { get; }
value = iDataSeries.YType
Bekommt den Typ der Y-Datenpunkte in diesem DataSeries @. Wird verwendet, um die Kompatibilität mit Achsentypen zu überprüfen
public IList YValues { get; }
value = iDataSeries.YValues
Bekommt die YValues dieser Datenreihe
Methoden
public void Clear()
iDataSeries.Clear()
Löscht die Serie und setzt interne Listen auf Null zurück
public int FindClosestLine(IComparable x, IComparable y, double xyScaleRatio, double xRadius, LineDrawMode drawNanAs)
result = iDataSeries.FindClosestLine(x, y, xyScaleRatio, xRadius, drawNanAs)
Suchregion ist ein vertikaler Bereich mit der Mitte in X und [maxXDistance] X Einheiten links und rechts.
- x
- Der X-Wert von Punkt [X Dateneinheiten, nicht Pixel]
- y
- Der Y-Wert von Punkt [Y Dateneinheiten, nicht Pixel]
- xyScaleRatio
- xUnitsPerPixel/yUnitsPerPixel
- xRadius
- Gibt die Suchregion in X-Einheiten an (Ticks für DateTime oder TimeSpan)
- drawNanAs
- gibt an, wie man mit NAN-Elementen umgeht
Rückgabe: Der Index des ersten Punktes in der Linie, -1, wenn nicht gefunden (wenn Zählung Null ist)
public int FindClosestPoint(IComparable x, IComparable y, double xyScaleRatio, double maxXDistance)
result = iDataSeries.FindClosestPoint(x, y, xyScaleRatio, maxXDistance)
Suchregion ist ein vertikaler Bereich mit der Mitte in X und [maxXDistance] X Einheiten links und rechts.
- x
- Der X-Wert von Punkt [X Dateneinheiten, nicht Pixel]
- y
- Der Y-Wert von Punkt [Y Dateneinheiten, nicht Pixel]
- xyScaleRatio
- xUnitsPerPixel/yUnitsPerPixel
- maxXDistance
- Gibt die Suchregion in X-Einheiten an (Ticks für DateTime oder TimeSpan)
Rückgabe: Der Index des gefundenen Wertes, -1, falls nicht gefunden (wenn die Zahl Null ist)
public int FindIndex(IComparable x, SearchMode searchMode)
result = iDataSeries.FindIndex(x, searchMode)
Findet den Index zum DataSeries am angegebenen X-Wert
- x
- Der X-Wert, nach dem gesucht werden soll
- searchMode
- Die SearchMode zu verwendenden Optionen. Standard ist genau, wobei -1 zurückgegeben wird, wenn der Index nicht gefunden wird
Rückgabe: Der Index des gefundenen Wertes
public IndexRange GetIndicesRange(IRange visibleRange)
result = iDataSeries.GetIndicesRange(visibleRange)
Bekommt die ganzzahligen Indizes des XValues-Arrays, die sich derzeit im VisibleRange @ befinden, und einen unbestimmten Bereich ansonsten
- visibleRange
- Die VisibleRange um den Indexbereich zu erhalten
Rückgabe: Die Indizes zu den X-Data, die sich derzeit im Bereich befinden
public IRange GetWindowedYRange(IRange xRange, bool getPositiveRange)
result = iDataSeries.GetWindowedYRange(xRange, getPositiveRange)
Holt sich den YRange der Daten (min, max der Serie) im sichtbaren Bereichsbereich, wobei der Eingabebereich der VisibleRange ist.
- xRange
- Die X-Achsen-Reihe derzeit in Sicht
- getPositiveRange
- Wenn true, gibt eine, die nur positive Werte hat, e.g, wenn Sie ein Logarithmisches Diagramm anzeigen, kann dieser Wert eingestellt werden
Rückgabe: Der YRange der Daten in diesem Fenster
public IRange GetWindowedYRange(IndexRange xIndexRange, bool getPositiveRange)
result = iDataSeries.GetWindowedYRange(xIndexRange, getPositiveRange)
Erhält den YRange der Daten (min, max der Serie) im Eingang IndexRange, wobei Indizes Punktindizes in den Spalten DataSeries sind
- xIndexRange
- Die X-Achse Indizes derzeit in Sicht
- getPositiveRange
- Wenn true, gibt eine, die nur positive Werte hat, e.g, wenn Sie ein Logarithmisches Diagramm anzeigen, kann dieser Wert eingestellt werden
Rückgabe: Der YRange der Daten in diesem Fenster
public IRange GetWindowedYRange(IndexRange xIndexRange)
result = iDataSeries.GetWindowedYRange(xIndexRange)
Erhält den YRange der Daten (min, max der Serie) im Eingang IndexRange, wobei Indizes Punktindizes in den Spalten DataSeries sind
- xIndexRange
- Die X-Achse Indizes derzeit in Sicht
Rückgabe: Der YRange der Daten in diesem Fenster
public IRange GetWindowedYRange(IRange xRange)
result = iDataSeries.GetWindowedYRange(xRange)
Holt sich den YRange der Daten (min, max der Serie) im sichtbaren Bereichsbereich, wobei der Eingabebereich der VisibleRange ist.
- xRange
- Die X-Achsen-Reihe derzeit in Sicht
Rückgabe: Der YRange der Daten in diesem Fenster
public void InvalidateParentSurface(RangeMode rangeMode)
iDataSeries.InvalidateParentSurface(rangeMode)
Diese Methode ist äußerst nützlich, wenn IDataSeries in einem ViewModel und über MVVM an IRenderableSeries gebunden sind. Bitte beachten Sie den Parameter für die Ungültigerklärungsoptionen
- rangeMode
- Bietet RangeMode Ungültigkeitsoptionen für die übergeordnete Oberfläche
public HitTestInfo ToHitTestInfo(int index)
result = iDataSeries.ToHitTestInfo(index)
Wenn in einer abgeleiteten Klasse überschrieben, gibt eine HitTestInfo @ Struktur mit Daten über den Datenpunkt an den angegebenen Index
- index
- Der Index zum DataSeries
Rückgabe: Die HitTestInfo
public IPointSeries ToPointSeries(ResamplingMode resamplingMode, IndexRange pointRange, int viewportWidth, bool isCategoryAxis, bool? dataIsDisplayedAs2D, IRange visibleXRange, IPointResamplerFactory factory, object pointSeriesArg)
result = iDataSeries.ToPointSeries(resamplingMode, pointRange, viewportWidth, isCategoryAxis, dataIsDisplayedAs2D, visibleXRange, factory, pointSeriesArg)
Konvertiert den Standard YValues in IPointSeries, der zum Rendern von XY-Serien verwendet wird
- resamplingMode
- Die gewünschte ResamplingMode
- pointRange
- Der Integer-Indizes-Bereich im übergeordneten Datensatz
- viewportWidth
- Die aktuelle Breite des Viewports
- isCategoryAxis
- Wenn true, verwendet die Indizes, um die neu gesampelten X-Werte zu bilden, andernfalls verwendet sie die X-Werte selbst
- visibleXRange
- Der VisibleRange der XAxis zum Zeitpunkt des Resamplings
- factory
- Die PointResamplerFactory, die IPointResampler Instanzen zurückgibt
- dataIsDisplayedAs2D
- Wenn dies wahr ist, werden Daten als eine Scatter-Serie ohne Beziehung zwischen den Punkten dargestellt, e.g. keine Zeilenserie
- pointSeriesArg
- Zusätzlicher Parameter für die Punktreihe.
Rückgabe: Ein IPointSeries, das zum Rendern von XY-Serien verwendet wird
public IPointSeries ToPointSeries(IList column, ResamplingMode resamplingMode, IndexRange pointRange, int viewportWidth, bool isCategoryAxis)
result = iDataSeries.ToPointSeries(column, resamplingMode, pointRange, viewportWidth, isCategoryAxis)
OBSOLETE: ToPointSeriesüberlastung wurde veraltet, verwenden Sie ToPointSeries stattdessen und gegossen, um den Typ der Punktreihe zu korrigieren
- column
- resamplingMode
- pointRange
- viewportWidth
- isCategoryAxis
Ereignisse
public event EventHandler<DataSeriesChangedEventArgs> DataSeriesChanged
iDataSeries.DataSeriesChanged += handler
Ereignis wird ausgelöst, wenn Punkte hinzugefügt, entfernt oder eine oder mehrere DataSeries Eigenschaften geändert werden