SmartLabelStyle Classe

Referência

Definição

Namespace:: System.Web.UI.DataVisualization.Charting

Assembly:: System.Web.DataVisualization.dll

Importante

Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.

Fornece métodos e propriedades usados para executar o posicionamento de rótulo de ponto de dados inteligente baseado em regra para resolver problemas de sobreposição de rótulos de ponto 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: Object
SmartLabelStyle

Derivado: System.Web.UI.DataVisualization.Charting.AnnotationSmartLabelStyle

Atributos: TypeConverterAttribute

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

Comentários

Quando os rótulos inteligentes são habilitados, o gráfico reposiciona os rótulos de ponto de dados sobrepostos, com base em um conjunto de regras definidas pelo usuário.

Linhas de texto explicativo serão desenhadas para vincular o rótulo ao seu ponto de dados. Os atributos visuais da linha do texto explicativo podem ser controlados. Esses atributos visuais incluem cor, estilo de linha e largura de linha. As CalloutStyle CalloutLineAnchorCapStyle Propriedades e controlam os ornamentos, como as pontas de seta, que aparecem no final da linha do texto explicativo.

A CalloutLineColor propriedade pode ser definida como qualquer Color objeto. Se você definir a cor da linha do texto explicativo, também definirá automaticamente a cor do CalloutLineAnchorCapStyle e o ornamento definido pelo CalloutStyle .

A CalloutLineWidth propriedade controla a largura de pixel da linha do texto explicativo. O uso dessa propriedade também dimensionará os ornamentos do CalloutLineAnchorCapStyle e do CalloutStyle .

A movimentação de Rótulos inteligentes pode ser controlada por meio do uso de várias propriedades relacionadas a movimento. Elas definem as regras de movimento para a direção, a distância e se o rótulo de ponto de dados tem permissão para sair da área de plotagem. As regras de movimento padrão normalmente resolverão a maioria dos problemas. O MaxMovingDistance define um valor que especifica a distância máxima em pixels do ponto de dados que os rótulos de ponto de dados têm permissão para serem movidos em caso de sobreposição. A MinMovingDistance propriedade define um valor que especifica a distância mínima em pixels do ponto de dados que os rótulos de ponto de dados serão movidos em caso de sobreposição. Quando um rótulo de ponto de dados precisar ser reposicionado, o rótulo será movido pelo menos pelo número de pixels especificado.

A IsOverlappedHidden propriedade indica se os rótulos estão ocultos quando problemas de sobreposição não podem ser resolvidos. 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 instruções permitidas pelo MovingDirection , o rótulo de ponto de dados não será desenhado.

A MovingDirection propriedade define a (s) direção (ões) na qual o rótulo de ponto de dados pode ser movido. Essa propriedade aceita um LabelAlignmentStyles valor ou um bit-a-ou de vários LabelAlignmentStyles valores. O padrão é a-bit ou todos os LabelAlignmentStyles valores, para permitir o reposicionamento em todas as direções possíveis, exceto o centro do ponto de dados.

Os rótulos inteligentes não têm suporte para os seguintes tipos de gráfico:

Gráficos de barras: gráficos de barras e de cem por cento na pilha.
Gráficos de forma: gráficos de pizza, de rosca, polares e de radar.
Gráficos de intervalo: gráficos de intervalo, coluna de intervalo e barra de intervalos.
Gráficos de área empilhada: gráficos de área empilhada e de cem por cento de áreas empilhadas.

Construtores

SmartLabelStyle()

Inicializa uma nova instância da classe SmartLabelStyle.

Propriedades

AllowOutsidePlotArea	Obtém ou define um sinalizador que especifica se um objeto SmartLabelStyle pode ser desenhado fora da área de plotagem.
CalloutBackColor	Obtém ou define a cor da tela de fundo do texto explicativo do rótulo.
CalloutLineAnchorCapStyle	Obtém ou define o estilo de extremidade da ancoragem da linha de texto explicativo do rótulo.
CalloutLineColor	Obtém ou define a cor da linha de texto explicativo do rótulo.
CalloutLineDashStyle	Obtém ou define o estilo da linha de texto explicativo do rótulo.
CalloutLineWidth	Obtém ou define a largura da linha de texto explicativo do rótulo.
CalloutStyle	Obtém ou define o estilo de texto explicativo do objeto SmartLabelStyle reposicionado.
Enabled	Obtém ou define um sinalizador que indica se um algoritmo SmartLabelStyle está habilitado.
IsMarkerOverlappingAllowed	Obtém ou define um sinalizador que especifica se os rótulos de ponto podem se sobrepor a um marcador de ponto.
IsOverlappedHidden	Obtém ou define um sinalizador que indica se os rótulos sobrepostos que não puderem ser reposicionados serão ocultos.
MaxMovingDistance	Obtém ou define a distância máxima, em pixels, pela qual o objeto SmartLabelStyle sobreposto pode ser movido do marcador.
MinMovingDistance	Obtém ou define a distância mínima, em pixels, pela qual o objeto SmartLabelStyle sobreposto pode ser movido do marcador.
MovingDirection	Obtém ou define as direções nas quais é possível mover o objeto SmartLabelStyle sobreposto.

Métodos

Equals(Object)	Determina se o objeto especificado é igual ao objeto atual. (Herdado de Object)
GetHashCode()	Serve como a função de hash padrão. (Herdado de Object)
GetType()	Obtém o Type da instância atual. (Herdado de Object)
MemberwiseClone()	Cria uma cópia superficial do Object atual. (Herdado de Object)
ToString()	Retorna uma cadeia de caracteres que representa o objeto atual. (Herdado de Object)

Aplica-se a