IDataSeries
Define la interfaz base a DataSeries que proporciona un fuente de datos para BaseRenderableSeries
Implementa: ISuspendable
Propiedades
public bool AcceptsUnsortedData { get; set; }
value = iDataSeries.AcceptsUnsortedData
iDataSeries.AcceptsUnsortedData = value
Nuevo a v3.3: cuando AcceptsUnsortedData es falso, el DataSeries@ con lanzamiento InvalidOperationException si se anexan datos no variados. Los datos no deseados pueden resultar en un rendimiento mucho más lento. Para desactivar este cheque, establece AcceptsUnsortedData = verdadero.
public int Count { get; }
value = iDataSeries.Count
Obtiene el número de puntos en esta serie de datos
public DataSeriesType DataSeriesType { get; }
value = iDataSeries.DataSeriesType
Consigue el DataSeriesType para esto DataSeries
public int? FifoCapacity { get; set; }
value = iDataSeries.FifoCapacity
iDataSeries.FifoCapacity = value
Obtiene o establece el tamaño del búfer FIFO. Si null, entonces las dataseries es ilimitada. Si se establece un valor, cuando el recuento de puntos alcance este valor, los puntos más antiguos serán descartados
public bool HasValues { get; }
value = iDataSeries.HasValues
Obtiene si el DataSeries tiene valores (no está vacío)
public bool IsAttached { get; }
value = iDataSeries.IsAttached
Se indica si la actual DataSeries se adjunta a DataSet
public bool IsFifo { get; }
value = iDataSeries.IsFifo
Obtiene si las dataseries se comportan como un FIFO. Si es cierto, cuando se alcanza el FifoCapacity, los viejos puntos serán descartados a favor de nuevos puntos, dando lugar a un gráfico de desplazamiento
public bool IsSecondary { get; }
value = iDataSeries.IsSecondary
Si es cierto, esta serie de datos no será seleccionada para el cálculo del rango de gráficos.
public bool IsSorted { get; }
value = iDataSeries.IsSorted
Obtiene si este DataSeries contiene datos clasificados en la dirección X. Nota: Los datos clasificados resultarán en operaciones de indexación mucho más rápidas. Si es posible, trate de mantener sus datos ordenados en la dirección X.
public IComparable LatestYValue { get; }
value = iDataSeries.LatestYValue
Obtiene el último Y-Value de la DataSeries
public IUltrachartSurface ParentSurface { get; set; }
value = iDataSeries.ParentSurface
iDataSeries.ParentSurface = value
Obtiene o establece el padre IUltrachartSurface que esta instancia IDataSeries es adjunta a
public string SeriesName { get; set; }
value = iDataSeries.SeriesName
iDataSeries.SeriesName = value
Obtiene o establece el nombre de esta serie
public Lock SyncRoot { get; }
value = iDataSeries.SyncRoot
Consigue un objeto de sincronización utilizado para bloquear esta serie de datos. También se bloquea en el apéndice, actualización, eliminación o despejado
public IComparable XMax { get; }
value = iDataSeries.XMax
Obtiene el valor máximo calculado en X para esta serie
public IComparable XMin { get; }
value = iDataSeries.XMin
Obtiene el valor mínimo calculado en X para esta serie
public IRange XRange { get; }
value = iDataSeries.XRange
Consigue las dimensiones totales de la IDataSeries@ en la X-Dirección
public Type XType { get; }
value = iDataSeries.XType
Consigue el tipo de puntos X-data en este DataSeries. Se utiliza para comprobar la compatibilidad con tipos Axis
public IList XValues { get; }
value = iDataSeries.XValues
Obtiene los XValues de esta dataseries
public IComparable YMax { get; }
value = iDataSeries.YMax
Obtiene el valor máximo calculado en Y para esta serie
public IComparable YMin { get; }
value = iDataSeries.YMin
Obtiene el valor mínimo calculado en Y para esta serie
public IRange YRange { get; }
value = iDataSeries.YRange
Consigue las dimensiones totales de la IDataSeries@ en la Y-Dirección
public Type YType { get; }
value = iDataSeries.YType
Consigue el tipo de puntos Y-data en este DataSeries. Se utiliza para comprobar la compatibilidad con tipos Axis
public IList YValues { get; }
value = iDataSeries.YValues
Obtiene los valores de esta serie de datos
Métodos
public void Clear()
iDataSeries.Clear()
Limpia la serie, restablecimiento de listas internas a tamaño cero
public int FindClosestLine(IComparable x, IComparable y, double xyScaleRatio, double xRadius, LineDrawMode drawNanAs)
result = iDataSeries.FindClosestLine(x, y, xyScaleRatio, xRadius, drawNanAs)
Encuentra la línea más cercana a un punto con valor X y Y dado. Región de búsqueda es una zona vertical con centro en X y [maxXDistance] X unidades a izquierda y derecha
- x
- El valor X del punto [unidades de datos X, no píxeles]
- y
- El valor Y del punto [Y unidades de datos, no píxeles]
- xyScaleRatio
- xUnitsPerPixel/yUnitsPerPixel
- xRadius
- especifica región de búsqueda en unidades X (ticks para DateTime o TimeSpan)
- drawNanAs
- especifica cómo manejar elementos NAN
Devuelve: El índice de primer punto en línea, -1 si no se encuentra (cuando cuenta es cero)
public int FindClosestPoint(IComparable x, IComparable y, double xyScaleRatio, double maxXDistance)
result = iDataSeries.FindClosestPoint(x, y, xyScaleRatio, maxXDistance)
Encuentra el punto más cercano a un punto con valor X y Y dado. Región de búsqueda es una zona vertical con centro en X y [maxXDistance] X unidades a izquierda y derecha
- x
- El valor X del punto [unidades de datos X, no píxeles]
- y
- El valor Y del punto [Y unidades de datos, no píxeles]
- xyScaleRatio
- xUnitsPerPixel/yUnitsPerPixel
- maxXDistance
- especifica región de búsqueda en unidades X (ticks para DateTime o TimeSpan)
Devuelve: El índice del valor encontrado, -1 si no se encuentra (cuando el recuento es cero)
public int FindIndex(IComparable x, SearchMode searchMode)
result = iDataSeries.FindIndex(x, searchMode)
Encuentra el índice a la DataSeries@ en el valor X especificado
- x
- El valor X para buscar
- searchMode
- Las opciones SearchMode para usar. Default es exacta, donde -1 es devuelto si el índice no se encuentra
Devuelve: El índice del valor encontrado
public IndexRange GetIndicesRange(IRange visibleRange)
result = iDataSeries.GetIndicesRange(visibleRange)
Consigue los índices enteros de la matriz de los XValues que se encuentran actualmente en el VisibleRange@ pasado, y un rango indefinido de otra manera
- visibleRange
- VisibleRange@ para obtener el rango de índices
Devuelve: Los índices a la X-Data que están actualmente en rango
public IRange GetWindowedYRange(IRange xRange, bool getPositiveRange)
result = iDataSeries.GetWindowedYRange(xRange, getPositiveRange)
Consigue el YRange de los datos (min, max de la serie) en el rango de puntos de alcance visible de entrada, donde el rango de entrada es el VisibleRange
- xRange
- El rango X-Axis actualmente en vista
- getPositiveRange
- Si es cierto, devuelve un valor positivo, e.g@, al ver una carta Logarítmica, este valor podría ser fijado
Devuelve: El YRange de los datos en esta ventana
public IRange GetWindowedYRange(IndexRange xIndexRange, bool getPositiveRange)
result = iDataSeries.GetWindowedYRange(xIndexRange, getPositiveRange)
Consigue el YRange de los datos (min, max de la serie) en la entrada IndexRange@, donde los índices son índices de puntos en las columnas DataSeries
- xIndexRange
- Los índices X-Axis actualmente en vista
- getPositiveRange
- Si es cierto, devuelve un valor positivo, e.g@, al ver una carta Logarítmica, este valor podría ser fijado
Devuelve: El YRange de los datos en esta ventana
public IRange GetWindowedYRange(IndexRange xIndexRange)
result = iDataSeries.GetWindowedYRange(xIndexRange)
Consigue el YRange de los datos (min, max de la serie) en la entrada IndexRange@, donde los índices son índices de puntos en las columnas DataSeries
- xIndexRange
- Los índices X-Axis actualmente en vista
Devuelve: El YRange de los datos en esta ventana
public IRange GetWindowedYRange(IRange xRange)
result = iDataSeries.GetWindowedYRange(xRange)
Consigue el YRange de los datos (min, max de la serie) en el rango de puntos de alcance visible de entrada, donde el rango de entrada es el VisibleRange
- xRange
- El rango X-Axis actualmente en vista
Devuelve: El YRange de los datos en esta ventana
public void InvalidateParentSurface(RangeMode rangeMode)
iDataSeries.InvalidateParentSurface(rangeMode)
Puede llamarse para activar una rodaja en el padre UltrachartSurface. Este método es extremadamente útil cuando IDataSeries están en un ViewModel y se atan vía MVVVM a IRenderableSeries. Por favor, vea el parámetro para opciones de invalidación
- rangeMode
- Proporciona opciones de invalidación RangeModepara la superficie matriz
public HitTestInfo ToHitTestInfo(int index)
result = iDataSeries.ToHitTestInfo(index)
Cuando se sobrescribe en una clase derivada, devuelve un HitTestInfo struct que contiene datos sobre el punto de datos en el índice especificado
- index
- El índice a DataSeries
Devuelve: 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)
Convertirá el YValues predeterminado a IPointSeries que se utiliza para renderizar la serie XY
- resamplingMode
- El deseado ResamplingMode
- pointRange
- Los índices enteros varían en el conjunto de datos de los padres
- viewportWidth
- La anchura actual del puerto de visión
- isCategoryAxis
- Si es cierto, utiliza los índices para formar los valores X reampled, de lo contrario utiliza los valores X ellos mismos
- visibleXRange
- VisibleRange@ del XAxis en el momento de la reemparación
- factory
- PointResamplerFactory que devuelve IPointResampler
- dataIsDisplayedAs2D
- Si es cierto, los datos se presentan como una serie de dispersión sin relación entre los puntos, e.g. no una serie de líneas
- pointSeriesArg
- Parámetro adicional a la serie de puntos.
Devuelve: A IPointSeries que se utiliza para renderizar la serie XY
public IPointSeries ToPointSeries(IList column, ResamplingMode resamplingMode, IndexRange pointRange, int viewportWidth, bool isCategoryAxis)
result = iDataSeries.ToPointSeries(column, resamplingMode, pointRange, viewportWidth, isCategoryAxis)
OBSOLETE: ToPointSeries sobrecarga ha sido deprecatada, use ToPointSeries en lugar, y cast para corregir tipo de serie de puntos
- column
- resamplingMode
- pointRange
- viewportWidth
- isCategoryAxis
Eventos
public event EventHandler<DataSeriesChangedEventArgs> DataSeriesChanged
iDataSeries.DataSeriesChanged += handler
Evento planteado cada vez que se agregan puntos, eliminados o uno o más DataSeriescambios de propiedades