Web Components Filtro de realce do gráfico

    Os componentes do Gráfico Ignite UI for Web Components oferecem suporte a uma sobreposição de realce de dados que pode aprimorar a visualização da série plotada nesses gráficos, permitindo que você exiba um subconjunto dos dados plotados. Quando ativado, isso destacará um subconjunto de dados enquanto mostra o conjunto total com uma opacidade reduzida no caso de tipos de série de coluna e área e uma linha tracejada no caso de tipos de série de linha. Isso pode ajudá-lo a visualizar coisas como valores de destino versus valores reais com seu conjunto de dados. Esse recurso é demonstrado no exemplo a seguir:

    Observe que o IgcDataChartComponent recurso de realce de dados é suportado pelo e IgcCategoryChartComponent, mas é configurado de maneiras diferentes nesses controles devido à natureza de como esses controles funcionam. Uma coisa permanece constante com esse recurso, pois você precisa definir a highlightedValuesDisplayMode propriedade para Overlay se quiser ver o destaque. A seguir, explicaremos as diferentes configurações do recurso de filtro de destaque.

    Using Highlight Filter with DataChart

    ​IgcDataChartComponent Na API, grande parte da API de filtro de destaque acontece na própria série, principalmente definindo a highlightedDataSource propriedade como uma coleção que representa um subconjunto dos dados que você deseja destacar. A contagem dos itens no highlightedDataSource precisa corresponder à contagem dos dados associados à ItemsSource série que você deseja destacar e, no caso da série de categorias, ela usará o ValueMemberPath que você definiu como o caminho de realce por padrão. O exemplo na parte superior desta página usa o highlightedDataSource para IgcDataChartComponent mostrar a sobreposição.

    Caso o esquema não corresponda entre o e o highlightedDataSource​ ​ItemsSource da série, você pode configurar isso usando a HighlightedValueMemberPath propriedade na série. Além disso, se você quiser usar o ItemsSource da própria série como a fonte de destaque e tiver um caminho em seu item de dados que represente o subconjunto, você pode fazer isso. Isso é feito simplesmente definindo a HighlightedValueMemberPath propriedade para esse caminho e não fornecendo um highlightedDataSource.

    A opacidade reduzida dos tipos de série de coluna e área é configurável definindo a highlightedValuesFadeOpacity propriedade na série. Você também pode definir a highlightedValuesDisplayMode propriedade como Hidden se não quiser ver a sobreposição.

    A parte da série mostrada pelo filtro de realce será representada nas camadas de legenda e dica de ferramenta do gráfico separadamente. Você pode configurar o título que é fornecido na dica de ferramenta e na legenda definindo o highlightedTitleSuffix. Isso acrescentará o valor que você fornece ao final da chartTitle série.

    Se o DataLegend ou IgcDataToolTipLayerComponent for usado, a série realçada aparecerá agrupada. Isso pode ser gerenciado definindo a highlightedValuesDataLegendGroup propriedade na série para categorizá-los adequadamente.

    O exemplo a seguir demonstra o uso do recurso de sobreposição de agrupamento e realce de legenda de dados dentro do IgcDataChartComponent controle usando highlightedValuesDataLegendGroup:

    O exemplo a seguir demonstra o uso do recurso de sobreposição de agrupamento e realce de legenda de dados dentro do IgcDataChartComponent controle usando highlightedValuesDataLegendGroup:

    O exemplo a seguir demonstra o uso do recurso de sobreposição de realce de dados dentro do IgcDataChartComponent controle usando HighlightedValueMemberPath:

    Using Highlight Filter in CategoryChart

    O IgcCategoryChartComponent filtro de realce ocorre no gráfico definindo a initialHighlightFilter propriedade. Como o IgcCategoryChartComponent leva em conta todas as propriedades do item de dados subjacente por padrão, você também precisará definir o initialGroups no gráfico para que os dados possam ser agrupados e agregados de forma que você possa ter um subconjunto dos dados para filtrar. Você pode definir o initialGroups como um caminho de valor em seu item de dados subjacente para agrupar por um caminho que tenha valores duplicados.

    Semelhante ao IgcDataChartComponent, a highlightedValuesDisplayMode propriedade também está exposta no IgcCategoryChartComponent. Caso não queira ver a sobreposição, você pode definir essa propriedade como Hidden.

    O exemplo a seguir demonstra o uso do recurso de sobreposição de realce de dados dentro do IgcCategoryChartComponent controle:

    Additional Resources

    Você pode encontrar mais informações sobre recursos de gráfico relacionados nestes tópicos:

    API References

    A seguir está uma lista de membros da API mencionados nas seções acima:

    IgcCategoryChartComponent Properties IgcDataChartComponent Properties
    highlightedDataSource highlightedDataSource
    highlightedTitleSuffix highlightedTitleSuffix
    CategoryChart.HighlightedValueMemberPath Series.HighlightedValueMemberPath
    highlightedValuesDisplayMode highlightedValuesDisplayMode
    highlightedValuesFadeOpacity highlightedValuesFadeOpacity
    highlightedValuesDisplayMode highlightedValuesDisplayMode
    initialHighlightFilter
    initialGroups