IDataSeries
Define a interface de base para DataSeries que fornece uma fonte de dados para BaseRenderableSeries
Implementa: ISuspendable
Propriedades
public bool AcceptsUnsortedData { get; set; }
value = iDataSeries.AcceptsUnsortedData
iDataSeries.AcceptsUnsortedData = value
Novo para v3.3: quando AcceptsUnsortedDataé false, o DataSeries com lançamento de InvalidOperationException se dados não sorteados forem adicionados. Dados não sorteados não intencionais podem resultar em desempenho muito mais lento. Para desativar esta verificação, defina AcceptsUnsortedData = true.
public int Count { get; }
value = iDataSeries.Count
Obtém o número de pontos nesta série de dados
public DataSeriesType DataSeriesType { get; }
value = iDataSeries.DataSeriesType
Obtém o DataSeriesType para este DataSeries
public int? FifoCapacity { get; set; }
value = iDataSeries.FifoCapacity
iDataSeries.FifoCapacity = value
Obtém ou define o tamanho do buffer FIFO. Se nulo, então a série de dados é ilimitada. Se um valor for definido, quando a contagem de pontos atingir este valor, os pontos mais antigos serão descartados
public bool HasValues { get; }
value = iDataSeries.HasValues
Obtém se o DataSeries tem valores (não está vazio)
public bool IsAttached { get; }
value = iDataSeries.IsAttached
Obtém se o DataSeries está ligado a DataSet
public bool IsFifo { get; }
value = iDataSeries.IsFifo
Obtém se a série de dados se comporta como um FIFO. Se for Verdadeiro, quando o FifoCapacity for atingido, os pontos antigos serão descartados em favor de novos pontos, resultando em um gráfico de rolagem
public bool IsSecondary { get; }
value = iDataSeries.IsSecondary
Se for verdadeiro, esta série de dados não será selecionada para cálculo de intervalo de gráficos.
public bool IsSorted { get; }
value = iDataSeries.IsSorted
Obtém se este DataSeriescontém dados ordenados na direção X. Nota: Dados ordenados resultarão em operações de indexação muito mais rápidas. Se possível, tente manter os seus dados ordenados na direção X
public IComparable LatestYValue { get; }
value = iDataSeries.LatestYValue
Obtém o mais recente valor Y do DataSeries
public IUltrachartSurface ParentSurface { get; set; }
value = iDataSeries.ParentSurface
iDataSeries.ParentSurface = value
Obtém ou define o pai IUltrachartSurface a qual esta IDataSeries instância está anexada
public string SeriesName { get; set; }
value = iDataSeries.SeriesName
iDataSeries.SeriesName = value
Obtém ou define o nome desta série
public Lock SyncRoot { get; }
value = iDataSeries.SyncRoot
Obtém um objeto de sincronização usado para bloquear esta série de dados. Também está bloqueado ao adicionar, atualizar, remover ou limpar
public IComparable XMax { get; }
value = iDataSeries.XMax
Obtém o valor máximo calculado em X para esta série
public IComparable XMin { get; }
value = iDataSeries.XMin
Obtém o valor mínimo calculado em X para esta série
public IRange XRange { get; }
value = iDataSeries.XRange
Obtém as extensões totais do IDataSeries na Direção X
public Type XType { get; }
value = iDataSeries.XType
Obtém o Tipo de pontos de dados X neste DataSeries. Usado para verificar a compatibilidade com os tipos Axis
public IList XValues { get; }
value = iDataSeries.XValues
Obtém os XValues desta série de dados
public IComparable YMax { get; }
value = iDataSeries.YMax
Obtém o valor máximo calculado em Y para esta série
public IComparable YMin { get; }
value = iDataSeries.YMin
Obtém o valor mínimo calculado em Y para esta série
public IRange YRange { get; }
value = iDataSeries.YRange
Obtém as extensões totais do IDataSeries na Direção Y
public Type YType { get; }
value = iDataSeries.YType
Obtém o Tipo de pontos de dados Y neste DataSeries. Usado para verificar a compatibilidade com os tipos Axis
public IList YValues { get; }
value = iDataSeries.YValues
Obtém os YVales desta série de dados
Métodos
public void Clear()
iDataSeries.Clear()
Limpa a série, redefinindo listas internas para tamanho zero
public int FindClosestLine(IComparable x, IComparable y, double xyScaleRatio, double xRadius, LineDrawMode drawNanAs)
result = iDataSeries.FindClosestLine(x, y, xyScaleRatio, xRadius, drawNanAs)
Encontra a linha mais próxima de um ponto com o valor X e Y indicado. A região de pesquisa é uma área vertical com centro em X e [maxXDistance] unidades X para esquerda e direita
- x
- O valor X do ponto [unidades de dados X, não pixels]
- y
- O valor Y do ponto [unidades de dados Y, não pixels]
- xyScaleRatio
- xUnitsPerPixel/yUnitsPerPixel
- xRadius
- especifica a região de pesquisa em unidades X (pontos para DateTime@ ou TimeSpan)
- drawNanAs
- especifica como lidar com elementos NAN
Retorna: O índice do primeiro ponto na linha, -1 se não foi encontrado (quando a contagem é zero)
public int FindClosestPoint(IComparable x, IComparable y, double xyScaleRatio, double maxXDistance)
result = iDataSeries.FindClosestPoint(x, y, xyScaleRatio, maxXDistance)
Encontra o ponto mais próximo de um ponto com o valor X e Y indicado. A região de pesquisa é uma área vertical com centro em X e [maxXDistance] unidades X para esquerda e direita
- x
- O valor X do ponto [unidades de dados X, não pixels]
- y
- O valor Y do ponto [unidades de dados Y, não pixels]
- xyScaleRatio
- xUnitsPerPixel/yUnitsPerPixel
- maxXDistance
- especifica a região de pesquisa em unidades X (pontos para DateTime@ ou TimeSpan)
Retorna: O índice do valor encontrado, -1 se não encontrado (quando a contagem é zero)
public int FindIndex(IComparable x, SearchMode searchMode)
result = iDataSeries.FindIndex(x, searchMode)
Localiza o índice para DataSeries no valor X especificado
- x
- O valor X a procurar
- searchMode
- As opções SearchMode a usar. O padrão é exato, onde - 1 é retornado se o índice não for encontrado
Retorna: O índice do valor encontrado
public IndexRange GetIndicesRange(IRange visibleRange)
result = iDataSeries.GetIndicesRange(visibleRange)
Obtém os índices inteiros do array XValues que estão atualmente no VisibleRange passado, e um intervalo indefinido de outra forma
- visibleRange
- O VisibleRange para obter o intervalo de índices
Retorna: Os índices para os dados X que estão atualmente no intervalo
public IRange GetWindowedYRange(IRange xRange, bool getPositiveRange)
result = iDataSeries.GetWindowedYRange(xRange, getPositiveRange)
Obtém o YRange dos dados (min, máx. da série) no intervalo de pontos de alcance visível de entrada, onde o intervalo de entrada é o VisibleRange
- xRange
- O intervalo X- Axis atualmente em vista
- getPositiveRange
- Se true, retorna um que só tem valores positivos, e.g, ao visualizar um gráfico logarítmico este valor pode ser definido
Retorna: O intervalo Y dos dados nesta janela
public IRange GetWindowedYRange(IndexRange xIndexRange, bool getPositiveRange)
result = iDataSeries.GetWindowedYRange(xIndexRange, getPositiveRange)
Obtém o YRange dos dados (min, máx. da série) na entrada IndexRange, onde os índices são índices de pontos nas colunas DataSeries@
- xIndexRange
- Os índices X-Axis atualmente em vista
- getPositiveRange
- Se true, retorna um que só tem valores positivos, e.g, ao visualizar um gráfico logarítmico este valor pode ser definido
Retorna: O intervalo Y dos dados nesta janela
public IRange GetWindowedYRange(IndexRange xIndexRange)
result = iDataSeries.GetWindowedYRange(xIndexRange)
Obtém o YRange dos dados (min, máx. da série) na entrada IndexRange, onde os índices são índices de pontos nas colunas DataSeries@
- xIndexRange
- Os índices X-Axis atualmente em vista
Retorna: O intervalo Y dos dados nesta janela
public IRange GetWindowedYRange(IRange xRange)
result = iDataSeries.GetWindowedYRange(xRange)
Obtém o YRange dos dados (min, máx. da série) no intervalo de pontos de alcance visível de entrada, onde o intervalo de entrada é o VisibleRange
- xRange
- O intervalo X- Axis atualmente em vista
Retorna: O intervalo Y dos dados nesta janela
public void InvalidateParentSurface(RangeMode rangeMode)
iDataSeries.InvalidateParentSurface(rangeMode)
Pode ser chamado para desencadear um desenho no pai UltrachartSurface. Este método é extremamente útil quando IDataSeries estão em ViewModel e estão ligados via MVVM para IRenderableSeries. Por favor, veja o parâmetro para opções de invalidação
- rangeMode
- Fornece opções de invalidação RangeModepara a superfície pai
public HitTestInfo ToHitTestInfo(int index)
result = iDataSeries.ToHitTestInfo(index)
Quando substituído em uma classe derivada, retorna uma HitTestInfo struct contendo dados sobre o ponto de dados no índice especificado
- index
- O índice para DataSeries
Retorna: A 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)
Converte o YValues padrão para IPointSeries que é usado para renderizar séries XY
- resamplingMode
- O desejado ResamplingMode
- pointRange
- O intervalo inteiro de índices no conjunto de dados pai
- viewportWidth
- A largura atual da janela
- isCategoryAxis
- Se true, usa os índices para formar os valores X reamostrados, então usa os próprios X-Valores
- visibleXRange
- O VisibleRange dos XAxis no momento da reamostragem ocorre
- factory
- O PointResamplerFactory que retorna IPointResampler instâncias
- dataIsDisplayedAs2D
- Se true, então os dados são apresentados como uma série de dispersão sem relação entre os pontos, e.g. not a line series
- pointSeriesArg
- Parâmetro adicional para a série de pontos.
Retorna: Uma IPointSeries que é usada para renderizar séries 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 foi desprecada, use ToPointSeries@ em vez disso, e molde para corrigir o tipo de série de pontos
- column
- resamplingMode
- pointRange
- viewportWidth
- isCategoryAxis
Eventos
public event EventHandler<DataSeriesChangedEventArgs> DataSeriesChanged
iDataSeries.DataSeriesChanged += handler
Evento levantado sempre que pontos são adicionados, removidos ou uma ou mais DataSeries properties changes