Legend Classe

Definição

Espaço de Nomes:
System.Windows.Forms.DataVisualization.Charting
Assemblagem:
System.Windows.Forms.DataVisualization.dll

Representa a lenda da imagem do gráfico.

public ref class Legend : System::Windows::Forms::DataVisualization::Charting::ChartNamedElement
public class Legend : System.Windows.Forms.DataVisualization.Charting.ChartNamedElement
type Legend = class
    inherit ChartNamedElement
Public Class Legend
Inherits ChartNamedElement
Herança
Object
ChartElement
ChartNamedElement
Legend

Observações

A Legend classe encapsula toda a funcionalidade da Chart legenda do controlo e é exposta usando a Legends propriedade de coleção do objeto raiz Chart .

Pode haver qualquer número de legendas para uma imagem de gráfico.

As lendas podem:

  • Estar acoplado e alinhado.

  • Pode ser exibido dentro ou fora das áreas do mapa representado.

  • Encaixam automaticamente no conteúdo deles.

  • Use um estilo pré-definido, como linha, coluna ou tabela.

  • Use hachuras, cores em gradiente e imagens de fundo.

  • Seja dimensionado e posicionado em qualquer lugar da imagem do gráfico.

Os itens lendários são representados pelo LegendItem objeto e são itens padrão ou personalizados. Itens personalizados não estão associados a dados e podem ser adicionados, eliminados e modificados usando a CustomItems propriedade.

Os itens por defeito são automaticamente adicionados à lenda, e são os nomes dos pontos de dados representados para os gráficos de rosquinhas e de pizza.

Para todos os outros tipos de gráficos, os itens padrão são os nomes das séries de dados plotadas. Cada série tem uma Legend propriedade que define o nome da legenda que será utilizada. Um item de legenda não será criado para uma série se a IsVisibleInLegend propriedade estiver definida como false. O texto destes itens padrão pode ser alterado usando a LegendText propriedade. Esta propriedade permitirá especificar palavras-chave pré-definidas que serão substituídas pelos seus valores apropriados em tempo de execução.

Se tiver um gráfico circular e definir a Label propriedade, ele também define o texto da legenda para o valor que definiu para as etiquetas. Se quiseres definir o texto com um valor diferente, podes definir a LegendText propriedade. Na maioria dos casos, deveria definir a LegendText propriedade como "#AXISLABEL" ou "#VALX".

Os símbolos da série Legend são retângulos, pontos ou linhas. O tipo de símbolo é definido automaticamente pelo gráfico e depende do tipo de gráfico representado.

O texto das legendas, por defeito, é automaticamente dimensionado. Pode desativar o dimensionamento automático do texto legendário desativando a IsTextAutoFit propriedade. Quando esta propriedade é definida para false, o tamanho do texto da legenda é determinado pela propriedade Tamanho da legenda Font. Se a IsTextAutoFit propriedade estiver ativada, determina AutoFitMinFontSize o tamanho mínimo de fonte que um item legendário pode ter ao redimensionar.

A TextWrapThreshold propriedade define um limite para o número de caracteres que podem ser mostrados numa linha antes de o texto ser enrolado noutra linha. Se não quiser enrolar texto na legenda, defina o valor da TextWrapThreshold propriedade a zero. Por defeito, quando todo o texto da legenda não cabe na legenda, o texto será truncado. Podes definir o TextWrapThreshold na legenda para que o texto se enrole em vez de ser truncado.

Se o conteúdo da legenda não caber no espaço dado, as entradas da legenda são truncadas. Uma elipse indica que há mais entradas do que a legenda tem espaço para incluir. Para evitar que os itens da legenda sejam truncados, defina a posição e o tamanho da legenda usando a Position propriedade. Ao definir a posição ou tamanho da legenda, o gráfico já não pode posicionar automaticamente os elementos no gráfico. Em alguns casos, pode ser necessário posicionar manualmente outros elementos do gráfico para obter a aparência desejada.

Outra opção seria definir as tuas próprias colunas de células em vez de usares as definições padrão das legendas.

O Legend objeto tem uma Coleção CellColumn; cada objeto CellColumn representa uma coluna na Legenda. Uma coluna de células tem MaximumWidth propriedades MinimumWidth que podem ser usadas para ajustar o tamanho das colunas.

Quando a legenda contém muitas entradas, InterlacedRows pode ser usada para melhorar a legibilidade. Quando esta propriedade está definida para Verdadeiro, irá mostrar uma cor de fundo que pode definir usando a InterlacedRowsColor propriedade.

Por defeito, a legenda está posicionada no canto superior direito do gráfico. Esta posição pode ser modificada usando as Docking propriedades e Alignment da legenda. A legenda pode também ser associada a uma área cartográfica pelo uso da DockedToChartArea propriedade. Esta propriedade especifica o nome da área da carta para a qual a legenda deve ser acoplada. Além disso, a IsDockedInsideChartArea propriedade pode ser usada para exibir a legenda dentro de uma área de carta.

Quando IsDockedInsideChartArea está definida para Falso, a MaximumAutoSize propriedade define o tamanho máximo, em percentuais, da legenda dentro do gráfico disponível quando a legenda é posicionada automaticamente. Esta propriedade deve ser definida se quiser ajustar a largura ou altura da lenda depois de as propriedades de acoplamento estarem definidas.

A lenda pode ser modificada usando o CustomizeLegend evento.

Construtores

Name Description
Legend()

Inicializa uma nova instância da Legend classe.
Legend(String)

Inicializa uma nova instância da Legend classe com o nome de legenda especificado.

Propriedades

Name Description
Alignment

Obtém ou define o alinhamento da lenda.
AutoFitMinFontSize

Obtém ou define o tamanho mínimo da fonte que pode ser usado pelo algoritmo de autofitting para o texto da legenda.
BackColor

Obtém ou define a cor de fundo de uma lenda.
BackGradientStyle

Obtém ou define a orientação para o gradiente de fundo de uma legenda. Também determina se um gradiente é utilizado.
BackHatchStyle

Obtém ou define o estilo de hatching de uma lenda.
BackImage

Obtém ou define a imagem de fundo de uma lenda.
BackImageAlignment

Obtém ou define o alinhamento da imagem de fundo usado para o Unscaled modo de desenho.
BackImageTransparentColor

Recebe ou define uma cor que será substituída por uma cor transparente quando a imagem de fundo for desenhada.
BackImageWrapMode

Obtém ou define o modo de desenho da imagem de fundo da lenda.
BackSecondaryColor

Obtém ou define a cor secundária de um fundo de lenda.
BorderColor

Obtém ou define a cor da borda de uma lenda.
BorderDashStyle

Obtém ou define o estilo de fronteira de uma lenda.
BorderWidth

Obtém ou define a largura da borda de uma lenda.
CellColumns

Obtém o LegendCellColumnCollection objeto que contém a coleção de colunas de células para uma legenda.
CustomItems

Obtém um LegendItemsCollection objeto usado para itens de lenda personalizados.
DockedToChartArea

Obtém ou define o nome do ChartArea local onde a lenda será acoplada.
Docking

Recebe ou define um valor que determina se a legenda está em dock.
Enabled

Recebe ou define um valor que indica se a legenda está ativada.
Font

Obtém ou define um Font objeto, que é usado para definir as propriedades da fonte da legenda.
ForeColor

Obtém ou define a cor do texto da legenda.
HeaderSeparator

Obtém ou define o tipo de separador visual para o cabeçalho da legenda.
HeaderSeparatorColor

Obtém ou define a cor do separador para o cabeçalho da legenda.
InsideChartArea

Obtém ou define o nome da área do mapa onde a legenda é desenhada.
InterlacedRows

Recebe ou define uma bandeira que indica se as linhas de legenda serão desenhadas com cor de fundo entrelaçada.
InterlacedRowsColor

Obtém ou define a cor de fundo das linhas entrelaçadas da legenda.
IsDockedInsideChartArea

Recebe ou define uma bandeira que indica se a legenda está encaixada dentro ou fora da área do mapa.
IsEquallySpacedItems

Recebe ou define uma bandeira que indica se todos os itens legendários estão igualmente espaçados.
IsTextAutoFit

Recebe ou define uma bandeira que indica se o texto da legenda é automaticamente dimensionado.
ItemColumnSeparator

Obtém ou define o tipo de separador visual para as colunas da tabela de legendas.
ItemColumnSeparatorColor

Obtém ou define a cor do separador de colunas da tabela legenda.
ItemColumnSpacing

Obtém ou define o espaçamento das colunas da tabela legendária.
LegendItemOrder

Recebe ou define um valor que especifica a ordem em que os itens legendários são exibidos. Esta propriedade afeta apenas itens legendários adicionados automaticamente para a série de gráficos; Não tem efeito nos itens de lenda personalizados.
LegendStyle

Recebe ou define o estilo da lenda.
MaximumAutoSize

Obtém ou define o tamanho máximo da legenda, medido como percentagem da área do gráfico. Este valor é usado pelo algoritmo automático de layout.
Name

Recebe ou define o nome da lenda.
Position

Obtém ou define um ElementPosition objeto, que pode ser usado para obter ou definir a posição da legenda.
ShadowColor

Obtém ou definem a cor da sombra da lenda.
ShadowOffset

Obtém ou define o deslocamento de sombra, em pixels, da lenda.
TableStyle

Obtém ou define a mesa de lendas.
Tag

Obtém ou define um objeto associado a este elemento do mapa.

(Herdado de ChartElement)
TextWrapThreshold

Obtém ou define o número de caracteres que podem ser exibidos sequencialmente na legenda antes de o texto ser enrolado.
Title

Obtém ou define o texto do título da lenda.
TitleAlignment

Obtém ou define o alinhamento do título da lenda.
TitleBackColor

Obtém ou define a cor de fundo do título da lenda.
TitleFont

Obtém ou define a fonte do título da lenda.
TitleForeColor

Obtém ou define a cor do texto do título da legenda.
TitleSeparator

Obtém ou define o tipo de separador visual para o título da lenda.
TitleSeparatorColor

Obtém ou define a cor do separador de título da lenda.

Métodos

Name Description
Dispose()

Liberta os recursos usados pelo ChartElement.

(Herdado de ChartElement)
Dispose(Boolean)

Liberta os recursos não geridos usados pelo Legend e opcionalmente liberta os recursos geridos.
Equals(Object)

Determina se o especificado Object é igual à corrente ChartElement.

(Herdado de ChartElement)
GetHashCode()

Devolve uma função de hash para um determinado tipo.

(Herdado de ChartElement)
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 a corrente Object.

(Herdado de ChartElement)

Aplica-se a