SmartLabelStyle Classe

Definição

Fornece métodos e propriedades usados para realizar um posicionamento inteligente e baseado em regras de etiquetas de pontos de dados, para resolver questões sobrepostas de etiquetas de pontos de dados.

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
Herança
SmartLabelStyle
Derivado
Atributos

Exemplos

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;
}

Observações

Quando as etiquetas inteligentes estão ativadas, o gráfico reposiciona as etiquetas sobrepostas dos pontos de dados, com base num conjunto de regras definidas pelo utilizador.

Serão desenhadas linhas de chamada para ligar a etiqueta ao seu ponto de dados. Os atributos visuais da linha de chamada podem ser controlados. Estes atributos visuais incluem cor, estilo de linha e largura de linha. As CalloutStyle propriedades e CalloutLineAnchorCapStyle controlam os enfeites, como pontas de flecha, que aparecem no final da linha de chamada.

A CalloutLineColor propriedade pode ser definida para qualquer Color objeto. Se definir a cor da linha de chamada, também irá definir automaticamente a cor do CalloutLineAnchorCapStyle e o embelezamento definido pelo CalloutStyle.

A CalloutLineWidth propriedade controla a largura dos píxeis da linha de chamada. O uso desta propriedade também irá aumentar os embelezamentos do CalloutLineAnchorCapStyle e do CalloutStyle.

O movimento dos rótulos inteligentes pode ser controlado através do uso de várias propriedades relacionadas com o movimento. Estes definem as regras de movimento para a direção, distância e se o rótulo do ponto de dados pode sair da área de plotagem. As regras de movimento padrão normalmente resolvem a maioria dos problemas. Define MaxMovingDistance um valor que especifica a distância máxima em píxeis ao ponto de dados para a qual as etiquetas dos pontos de dados podem ser movidas em caso de sobreposição. A MinMovingDistance propriedade define um valor que especifica a distância mínima em píxeis a partir do ponto de dados que as etiquetas dos pontos de dados serão movidas em caso de sobreposição. Quando uma etiqueta de ponto de dados precisa de ser reposicionada, a etiqueta será movida pelo menos pelo número de píxeis especificado.

A IsOverlappedHidden propriedade indica se os rótulos estão ocultos quando questões sobrepostas não podem ser resolvidas. Se a IsOverlappedHidden propriedade for true, e o ponto de dados não puder ser desenhado dentro da área especificada por MinMovingDistance e MaxMovingDistance nas direções permitidas por MovingDirection, o rótulo do ponto de dados não será desenhado.

A MovingDirection propriedade define a(s) direção(ões) em que o rótulo do ponto de dados pode ser movido. Esta propriedade aceita um LabelAlignmentStyles valor ou um OR bit a bit de múltiplos LabelAlignmentStyles valores. O padrão é o OR bit a bit de todos os LabelAlignmentStyles valores, permitindo o reposicionamento em todas as direções possíveis, exceto para o centro do ponto de dados.

Etiquetas inteligentes não são suportadas para os seguintes tipos de gráficos:

  • Gráficos de barras: gráficos de barras e gráficos de barras empilhados a cem por cento.

  • Gráficos de formas: tarte, donut, polar e radar.

  • Gráficos de alcance: alcance, coluna de alcances e barras de alcance.

  • Gráficos de áreas empilhadas: gráficos de área empilhada e gráficos de área a cem por cento empilhados.

Construtores

Name Description
SmartLabelStyle()

Inicializa uma nova instância da SmartLabelStyle classe.

Propriedades

Name Description
AllowOutsidePlotArea

Recebe ou define um flag que especifica se um SmartLabelStyle objeto pode ser desenhado fora da área de plotagem.

CalloutBackColor

Recebe ou define a cor de fundo da chamada de etiqueta.

CalloutLineAnchorCapStyle

Recebe ou define o estilo de tampa âncora da linha de chamada de etiqueta.

CalloutLineColor

Obtém ou define a cor da linha de chamada da etiqueta.

CalloutLineDashStyle

Obtém ou define o estilo da linha de chamada do rótulo.

CalloutLineWidth

Obtém ou define a largura da linha de chamada de etiqueta.

CalloutStyle

Obtém ou define o estilo de chamada do objeto reposicionado SmartLabelStyle .

Enabled

Recebe ou define um flag que indica se um SmartLabelStyle algoritmo está ativado.

IsMarkerOverlappingAllowed

Recebe ou define uma bandeira que especifica se as etiquetas de pontos podem sobrepor-se a um marcador de ponto.

IsOverlappedHidden

Recebe ou define um flag que indica se etiquetas sobrepostas que não podem ser reposicionadas estarão ocultas.

MaxMovingDistance

Obtém ou define a distância máxima, em píxeis, à qual o objeto sobreposto SmartLabelStyle pode ser movido do marcador.

MinMovingDistance

Obtém ou define a distância mínima, em píxeis, para que o objeto sobreposto SmartLabelStyle possa ser movido do marcador.

MovingDirection

Obtém ou define a(s) direção(ões) em que o objeto sobreposto SmartLabelStyle pode ser movido.

Métodos

Name Description
Equals(Object)

Determina se o objeto especificado é igual ao objeto atual.

(Herdado de Object)
GetHashCode()

Serve como função de hash predefinida.

(Herdado de Object)
GetType()

Obtém o Type da instância atual.

(Herdado de Object)
MemberwiseClone()

Cria uma cópia superficial do atual Object.

(Herdado de Object)
ToString()

Devolve uma cadeia que representa o objeto atual.

(Herdado de Object)

Aplica-se a