La clase Legend encapsula toda la funcionalidad de la leyenda del control Chart, y se expone utilizando la propiedad de colección Legends del objeto Chart raíz.
Puede haber cualquier número de leyendas para una imagen del gráfico.
Las leyendas pueden:
Esté acoplado y alineado.
Se debe mostrar dentro o fuera de las áreas del gráfico trazadas.
Ajuste automáticamente su contenido.
Utilice un estilo predefinido, como fila, columna o tabla.
Use sombreado, colores de degradado e imágenes de fondo.
Se debe dimensionar y colocar en cualquier parte dentro de la imagen del gráfico.
El objeto LegendItem representa los elementos de leyenda y son elementos predeterminados o personalizados. Los elementos personalizados no se asocian a los datos, y se pueden agregar, eliminar y modificar utilizando la propiedad CustomItems.
De forma predeterminada, los elementos predeterminados se agregan automáticamente a la leyenda y son los nombres de los puntos de datos trazados para los gráficos de anillos y circulares.
Para todos los otros tipos de gráfico, los elementos predeterminados son los nombres de la serie de datos trazada. Cada serie tiene una propiedad Legend que define el nombre de la leyenda que se utilizará. Un elemento de leyenda no se creará para una serie si la propiedad IsVisibleInLegend está establecida en false. El texto de estos elementos predeterminados se puede cambiar utilizando la propiedad LegendText. Esta propiedad le permitirá especificar palabras clave predefinidas que serán reemplazadas por sus valores adecuados en tiempo de ejecución.
Si tiene un gráfico circular y establece la propiedad Label, también establecerá el texto de la leyenda en el valor que establece para las etiquetas. Si desea establecer el texto en un valor diferente, puede establecer la propiedad LegendText. En la mayoría de los casos, convendría establecer la propiedad LegendText en "#AXISLABEL" o "#VALX".
Los símbolos de serie de leyenda son rectángulos, puntos o líneas. El tipo de símbolo lo establece automáticamente el gráfico y depende del tipo de gráfico trazado.
De forma predeterminada, el texto de la leyenda se dimensiona automáticamente. Puede deshabilitar el tamaño automático del texto de la leyenda deshabilitando la propiedad IsTextAutoFit. Cuando esta propiedad está establecida en false, la propiedad Size de la leyenda determina el tamaño del texto de la leyenda Font. Si la propiedad IsTextAutoFit está habilitada, la propiedad AutoFitMinFontSize determina el tamaño de fuente mínimo que puede tener un elemento de leyenda al cambiar el tamaño.
La propiedad TextWrapThreshold define un límite en el número de caracteres que se puede mostrar en una línea antes de que el texto se ajuste a otra línea. Si no desea ajustar el texto en la leyenda, establezca el valor de la propiedad TextWrapThreshold en cero. De forma predeterminada, cuando todo el texto de la leyenda no cabe en la leyenda, se truncará el texto. Puede establecer TextWrapThreshold en la leyenda para obtener el texto que se desea ajustar en lugar de truncarse.
Si el contenido de la leyenda no cabe en el espacio especificado, se truncan las entradas de la leyenda. Se mostrarán puntos suspensivos para indicar que hay más entradas de las que caben en la leyenda. Para evitar que se trunquen los elementos de leyenda, establezca la posición y tamaño de la leyenda utilizando propiedades Size y Position, respectivamente. Al establecer la posición o tamaño de la leyenda, el gráfico puede que ya no coloque automáticamente los elementos en el gráfico. En algunos casos, puede que deba colocar manualmente otros elementos de gráfico para lograr el aspecto deseado.
Otra opción sería definir sus propias columnas de celda en lugar de utilizar los valores de leyenda predeterminados.
El objeto Legend tiene una colección CellColumn; cada objeto CellColumn representa una columna de la leyenda. Una columna de celda tiene las propiedades MinimumWidth y MaximumWidth que se pueden utilizar para ajustar el tamaño de las columnas.
Cuando la leyenda contiene muchas entradas, se puede utilizar InterlacedRows para mejorar la legibilidad. Cuando esta propiedad se establece en True, muestra un color de fondo que se puede establecer utilizando la propiedad InterlacedRowsColor.
De forma predeterminada, la leyenda se coloca en el ángulo superior derecho del gráfico. Esta posición se puede modificar utilizando las propiedades Alignment y Docking de la leyenda. La leyenda también se puede asociar a una área del gráfico mediante el uso de la propiedad DockedToChartArea. Esta propiedad especifica el nombre del área del gráfico para la que se debería acoplar la leyenda. Además, la propiedad IsDockedInsideChartArea se puede utilizar para mostrar la leyenda dentro de un área del gráfico.
Cuando la propiedad IsDockedInsideChartArea está establecida en False, la propiedad MaximumAutoSize define el tamaño máximo, en porcentaje, de la leyenda dentro del gráfico disponible cuando se coloca automáticamente la leyenda. Esta propiedad se debería establecer si desea ajustar el ancho o alto de la leyenda una vez establecidas las propiedades de acoplamiento.
La leyenda se puede modificar utilizando el evento CustomizeLegend.
