SmartLabelStyle Clase
Definición
Importante
Parte de la información hace referencia a la versión preliminar del producto, que puede haberse modificado sustancialmente antes de lanzar la versión definitiva. Microsoft no otorga ninguna garantía, explícita o implícita, con respecto a la información proporcionada aquí.
Proporciona métodos y propiedades que se usan para la colocación inteligente de etiquetas de punto de datos basada en reglas con el fin de resolver problemas de etiquetas de punto de datos superpuestas.
public ref class SmartLabelStyle
[System.ComponentModel.TypeConverter(typeof(System.Web.UI.DataVisualization.Charting.NoNameExpandableObjectConverter))]
public class SmartLabelStyle
[<System.ComponentModel.TypeConverter(typeof(System.Web.UI.DataVisualization.Charting.NoNameExpandableObjectConverter))>]
type SmartLabelStyle = class
Public Class SmartLabelStyle
- Herencia
-
SmartLabelStyle
- Derivado
- Atributos
Ejemplos
Imports System.Web.UI.DataVisualization.Charting
Private Function SetSmartLabelsOptions()
' Enabling the SmartLabels™ attribute.
Chart1.Series("Series1").SmartLabels.Enabled = true
' Set the callout style.
Chart1.Series("Series1").SmartLabels.CalloutStyle = LabelCalloutStyle.Underlined
' Set the callout line color.
Chart1.Series("Series1").SmartLabels.CalloutLineColor = Color.Goldenrod;
' Set the callout line style.
Chart1.Series("Series1").SmartLabels.CalloutLineStyle = ChartDashStyle.Dash
' Set the callout line width.
Chart1.Series("Series1").SmartLabels.CalloutLineWidth = 3
' Set the callout line anchor cap.
Chart1.Series("Series1").SmartLabels.CalloutLineAnchorCap = LineAnchorCap.Arrow
End Function
using System.Web.UI.DataVisualization.Charting
private void SetSmartLabelsOptions()
{
// Enabling the SmartLabels™ attribute.
Chart1.Series["Series1"].SmartLabels.Enabled = true;
// Set the callout style.
Chart1.Series["Series1"].SmartLabels.CalloutStyle = LabelCalloutStyle.Underlined;
// Set the callout line color.
Chart1.Series["Series1"].SmartLabels.CalloutLineColor = Color.Goldenrod;
// Set the callout line style.
Chart1.Series["Series1"].SmartLabels.CalloutLineStyle = ChartDashStyle.Dash;
// Set the callout line width.
Chart1.Series["Series1"].SmartLabels.CalloutLineWidth = 3;
// Set the callout line anchor cap.
Chart1.Series["Series1"].SmartLabels.CalloutLineAnchorCap = LineAnchorCap.Arrow;
}
Comentarios
Cuando las etiquetas inteligentes están habilitadas, el gráfico vuelve a colocar etiquetas de punto de datos superpuestas, en función de un conjunto de reglas definidas por el usuario.
Las líneas de llamada se dibujarán para vincular la etiqueta con su punto de datos. Se pueden controlar los atributos visuales de la línea de llamada. Estos atributos visuales incluyen color, estilo de línea y ancho de línea. Las propiedades y controlan las adornos, como las puntas de flecha, que aparecen CalloutStyle al final de la línea de CalloutLineAnchorCapStyle llamada.
La CalloutLineColor propiedad se puede establecer en cualquier objeto Color . Si establece el color de la línea de llamada, también establecerá automáticamente el color de y el adorno CalloutLineAnchorCapStyle definido por CalloutStyle .
La CalloutLineWidth propiedad controla el ancho de píxel de la línea de llamada. El uso de esta propiedad también escalará las adornos de CalloutLineAnchorCapStyle y CalloutStyle .
El movimiento de etiquetas inteligentes se puede controlar mediante el uso de varias propiedades relacionadas con el movimiento. Definen las reglas de movimiento para la dirección, la distancia y si la etiqueta del punto de datos puede salir del área de trazado. Las reglas de movimiento predeterminadas normalmente resolverán la mayoría de los problemas. define un valor que especifica la distancia máxima en píxeles desde el punto de datos en el que se permite mover las etiquetas de punto de datos en MaxMovingDistance caso de superposición. La propiedad define un valor que especifica la distancia mínima en píxeles desde el punto de datos en el que se mueven las etiquetas de punto de datos en MinMovingDistance caso de superposición. Cuando sea necesario cambiar la posición de una etiqueta de punto de datos, la etiqueta se desplazará por al menos el número de píxeles especificado.
La IsOverlappedHidden propiedad indica si las etiquetas están ocultas cuando no se pueden resolver problemas superpuestos. Si la propiedad es y el punto de datos no se puede dibujar dentro del área especificada por y en las direcciones permitidas por , no se dibujará la etiqueta IsOverlappedHidden true
del punto de MinMovingDistance MaxMovingDistance MovingDirection datos.
La propiedad define las direcciones en las que se puede mover la etiqueta del MovingDirection punto de datos. Esta propiedad acepta un LabelAlignmentStyles valor o un OR bit a bit de varios LabelAlignmentStyles valores. El valor predeterminado es el or bit a bit de todos los valores, para permitir el reposición en todas las direcciones posibles, excepto en el centro LabelAlignmentStyles del punto de datos.
Las etiquetas inteligentes no se admiten para los siguientes tipos de gráfico:
Gráficos de barras: gráficos de barras y gráficos de barras cien por cien apiladas.
Gráficos de formas: gráficos circulares, de anillos, polares y de radar.
Gráficos de intervalos: intervalo, columna de intervalo y gráficos de barras de intervalo.
Gráficos de áreas apiladas: gráficos de área apilada y gráficos de áreas cien por cien apiladas.
Constructores
SmartLabelStyle() |
Inicializa una nueva instancia de la clase SmartLabelStyle. |
Propiedades
AllowOutsidePlotArea |
Obtiene o establece una marca que especifica si un objeto SmartLabelStyle se puede dibujar fuera del área de trazado. |
CalloutBackColor |
Obtiene o establece el color de fondo de la llamada de etiqueta. |
CalloutLineAnchorCapStyle |
Obtiene o establece el estilo del límite de delimitador de la línea de llamada de etiqueta. |
CalloutLineColor |
Obtiene o establece el color de la línea de llamada de etiqueta. |
CalloutLineDashStyle |
Obtiene o establece el estilo de la línea de llamada de etiqueta. |
CalloutLineWidth |
Obtiene o establece el ancho de la línea de llamada de etiqueta. |
CalloutStyle |
Obtiene o establece el estilo de llamada del objeto SmartLabelStyle reubicado. |
Enabled |
Obtiene o establece una marca que indica si un algoritmo SmartLabelStyle está habilitado. |
IsMarkerOverlappingAllowed |
Obtiene o establece una marca que especifica si las etiquetas de punto de datos pueden superponerse a un marcador de punto de datos. |
IsOverlappedHidden |
Obtiene o establece una marca que indica si se ocultarán las etiquetas superpuestas que no se puedan cambiar de posición. |
MaxMovingDistance |
Obtiene o establece la distancia máxima, en píxeles, que el objeto SmartLabelStyle superpuesto se puede mover del marcador. |
MinMovingDistance |
Obtiene o establece la distancia mínima, en píxeles, que el objeto SmartLabelStyle superpuesto se puede mover del marcador. |
MovingDirection |
Obtiene o establece las direcciones en las que se puede mover el objeto SmartLabelStyle superpuesto. |
Métodos
Equals(Object) |
Determina si el objeto especificado es igual que el objeto actual. (Heredado de Object) |
GetHashCode() |
Sirve como la función hash predeterminada. (Heredado de Object) |
GetType() |
Obtiene el Type de la instancia actual. (Heredado de Object) |
MemberwiseClone() |
Crea una copia superficial del Object actual. (Heredado de Object) |
ToString() |
Devuelve una cadena que representa el objeto actual. (Heredado de Object) |