Legendas em controles de gráfico
Legendas permitem que as pessoas distinguir entre os pontos de séries e os dados da imagem do gráfico. Eles são armazenados como Legend objetos no Chart.Legends propriedade de coleção.
Por padrão, uma legenda não é encaixada para uma área do gráfico e é exibida o lado de todas as áreas do gráfico. Você pode encaixar uma legenda a uma área de gráfico usando o Legend do objeto DockedToChartArea propriedade. Cada série individualmente é atribuído a uma legenda usando o Series do objeto Legend propriedade.
Na maioria dos tipos de gráfico, cada item de legenda representa uma série plotada. Pizza, rosca, funil ou pirâmide, cada item de legenda representa um ponto de dados na série.
Por padrão, o controle do gráfico cria automaticamente duas colunas em uma legenda, um para indicar as cores dos dados plotados e outro que mostra o texto da legenda. Você pode especificar o texto da legenda no Series.LegendText propriedade ou DataPoint.LegendText propriedade.
Adicionando legendas em tempo de execução
Para adicionar uma legenda a um gráfico em tempo de execução, certifique-se de que ela está ancorada à área de gráfico correto, atribuída a uma série de dados e que a série de dados IsVisibleInLegend está definida como true. O código a seguir demonstra isso.
' Create a new legend called "Legend2".
Chart1.Legends.Add(New Legend("Legend2"))
' Set Docking chart of the legend to the Default chart area.
Chart1.Legends("Legend2").DockToChartArea = "Default"
' Assign the legend to Series1.
Chart1.Series("Series1").Legend = "Legend2"
Chart1.Series("Series1").IsVisibleInLegend = true
// Create a new legend called "Legend2".
Chart1.Legends.Add(new Legend("Legend2"));
// Set Docking of the Legend chart to the Default Chart Area.
chart1.Legends["Legend2"].DockToChartArea = "Default";
// Assign the legend to Series1.
Chart1.Series["Series1"].Legend = "Legend2";
Chart1.Series["Series1"].IsVisibleInLegend = true;
Usar propriedades de um Legend objeto para personalizar a aparência da legenda, como Docking, Alignment, IsDockedInsideChartArea, Position, TableStyle, LegendStyle, MaximumAutoSize, Font, e InterlacedRows.
Usar títulos, cabeçalhos e colunas
O diagrama a seguir mostra os vários recursos de legenda e as propriedades correspondentes no Legend objeto.
Dica
Você não pode ajustar os itens de legenda individuais e células a Chart.Legends coleção.Para ajustá-las, use itens de legenda personalizado.
Ao usar o Legend.Title propriedade para especificar um título de legenda, use \n para indicar uma nova linha. Você também pode usar palavras-chave para que possa alterar o texto de acordo com a série de dados. Para obter mais informações, consulte palavras-chave.
Para personalizar o número de colunas na legenda, use o Legend.CellColumns propriedade de coleção. As colunas nessa propriedade se aplica a cada item de legenda é gerado automaticamente.
O código a seguir demonstra ambas as Legend.CellColumns propriedade e o uso de palavras-chave. Ele adiciona três colunas: uma para os nomes de série, um para o símbolo da série e outra para a média dos dados de cada série.
Chart1.Legends["Legend2"].CellColumns.Add(New LegendCellColumn("Name", LegendCellColumnType.Text, "#LEGENDTEXT"))
Chart1.Legends["Legend2"].CellColumns.Add(New LegendCellColumn("Sym", LegendCellColumnType.SeriesSymbol, ""))
Chart1.Legends["Legend2"].CellColumns.Add(New LegendCellColumn("Avg", LegendCellColumnType.Text, "#AVG{N2}"))
Chart1.Legends["Legend2"].CellColumns.Add(new LegendCellColumn("Name", LegendCellColumnType.Text, "#LEGENDTEXT"));
Chart1.Legends["Legend2"].CellColumns.Add(new LegendCellColumn("Sym", LegendCellColumnType.SeriesSymbol,""));
Chart1.Legends["Legend2"].CellColumns.Add(new LegendCellColumn("Avg", LegendCellColumnType.Text, "#AVG{N2}"));
Você pode ajustar a aparência de cada coluna e se sentir usando o LegendCellColumn propriedades do objeto, como MinimumWidth, MaximumWidth, Alignmnent, Margins, HeaderText, e ItemColumnsSeparator.
Consulte também
Conceitos
Itens de legenda personalizada