Leyendas en los controles Chart
Las leyendas permiten distinguir entre las series y los puntos de datos en la imagen del gráfico.Se almacenan como objetos Legend en la propiedad de colección Chart.Legends.
De forma predeterminada, una leyenda no se acopla a un área del gráfico y se muestra fuera de todas las áreas del gráfico.Puede acoplar una leyenda a un área del gráfico mediante la propiedad DockedToChartArea del objeto Legend.Mediante la propiedad Legend del objeto Series se asigna una leyenda a cada serie de forma individual.
En la mayoría de los tipos de gráfico, cada elemento de leyenda representa una serie trazada.En un gráfico circular, de anillos, de embudo o piramidal, cada elemento de leyenda representa un punto de datos de la serie.
De forma predeterminada, el control Chart crea automáticamente dos columnas en una leyenda, una para indicar los colores de los datos trazados y otra que muestra el texto de la leyenda.Puede especificar el texto de la leyenda en las propiedades Series.LegendText o DataPoint.LegendText.
Agregar leyendas en tiempo de ejecución
Para agregar una leyenda a un gráfico en tiempo de ejecución, asegúrese de que se acopla al área de gráfico correcta, de que se asigna a una serie de datos y de que la propiedad IsVisibleInLegend de la serie de datos se establece en true.El código siguiente muestra cómo hacerlo.
' 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;
Utilice las propiedades de un objeto Legend para personalizar el aspecto de la leyenda, como Docking, Alignment, IsDockedInsideChartArea, Position, TableStyle, LegendStyle, MaximumAutoSize, Font e InterlacedRows.
Usar títulos, encabezados y columnas
En el siguiente diagrama se muestran las diferentes características de leyenda y las propiedades correspondientes del objeto Legend.
.gif "Chart_Legend_Features")
Nota
No puede ajustar las celdas ni los elementos de leyenda individuales en la colección Chart.Legends.Para ajustarlos, utilice elementos de leyenda personalizados.
Cuando use la propiedad Legend.Title para especificar un título de la leyenda, use \n para indicar una nueva línea.También puede usar palabras clave para que el texto cambie según la serie de datos.Para obtener más información, vea Palabras clave.
Para personalizar el número de columnas de la leyenda, utilice la propiedad de colección Legend.CellColumns.Las columnas de esta propiedad se aplican a cada elemento de leyenda que se genera automáticamente.
En el ejemplo de código siguiente se muestra la propiedad Legend.CellColumns y el uso de palabras clave.Agrega tres columnas: una para el nombre de la serie, otra para el símbolo de la serie y otra para el promedio de datos en cada serie.
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}"));
Puede ajustar la apariencia de cada columna mediante las propiedades del objeto LegendCellColumn, como MinimumWidth, MaximumWidth, Alignmnent, Margins, HeaderText e ItemColumnsSeparator.
Vea también
Conceptos
Elementos de leyenda personalizados