Legend Classe

Definição

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

Comentários

A Legend classe encapsula toda a funcionalidade da Chart legenda do controle 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 legendas podem:

• Esteja encaixado e alinhado.

• Seja exibido dentro ou fora das áreas do gráfico plotado.

• Ajustar automaticamente seu conteúdo.

• Use um estilo predefinido, como linha, coluna ou tabela.

• Use hatching, cores de gradiente e imagens de plano de fundo.

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

Os itens de legenda são representados pelo LegendItem objeto e são itens padrão ou personalizados. Os itens personalizados não estão associados aos dados e podem ser adicionados, excluídos e modificados usando a CustomItems propriedade .

Por padrão, os itens padrão são adicionados automaticamente à legenda e são os nomes dos pontos de dados plotados para gráficos de rosca e pizza.

Para todos os outros tipos de gráfico, os itens padrão são os nomes da série de dados plotada. Cada série tem uma Legend propriedade que define o nome da legenda que será usada. Um item de legenda não será criado para uma série se a IsVisibleInLegend propriedade estiver definida falsecomo . O texto para esses itens padrão pode ser alterado usando a LegendText propriedade . Essa propriedade permitirá que você especifique palavras-chave predefinidas que serão substituídas por seus valores apropriados em tempo de execução.

Se você tiver um gráfico de pizza e definir a Label propriedade , ele também definirá o texto da legenda como o valor definido para os rótulos. Se você quiser definir o texto como um valor diferente, poderá definir a LegendText propriedade . Na maioria dos casos, você gostaria de definir a LegendText propriedade como "#AXISLABEL" ou "#VALX".

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

O texto da legenda por padrão é dimensionado automaticamente. Você pode desabilitar o dimensionamento automático do texto da legenda desabilitando a IsTextAutoFit propriedade . Quando essa propriedade é definida como false, o tamanho do texto da legenda é determinado pela propriedade Size da legenda Font. Se a IsTextAutoFit propriedade estiver habilitada, a AutoFitMinFontSize propriedade determinará o tamanho mínimo da fonte que um item de legenda pode ter ao redimensionar.

A TextWrapThreshold propriedade define um limite no número de caracteres que podem ser mostrados em uma linha antes que o texto seja encapsulado para outra linha. Se você não quiser encapsular o texto na legenda, defina o valor da TextWrapThreshold propriedade como zero. Por padrão, quando todo o texto da legenda não se ajustar à legenda, o texto será truncado. Você pode definir o TextWrapThreshold na legenda para que o texto seja encapsulado em vez de truncado.

Se o conteúdo da legenda não puder caber no espaço especificado, as entradas de legenda serão truncadas. Uma reticências é mostrada para indicar que há mais entradas do que a legenda tem espaço para. Para impedir que os itens de legenda sejam truncados, defina a posição e o tamanho da legenda usando a Position propriedade . Ao definir a posição ou o tamanho da legenda, o gráfico não pode mais posicionar automaticamente os elementos no gráfico. Em alguns casos, muitos precisam posicionar manualmente outros elementos do gráfico para alcançar a aparência desejada.

Outra opção seria definir suas próprias colunas de célula em vez de usar as configurações de legenda padrão.

O Legend objeto tem uma Coleção CellColumn; cada objeto CellColumn representa uma coluna na Legenda. Uma coluna de célula tem MaximumWidth propriedades e 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 essa propriedade for definida como True, ela exibirá uma cor de fundo que você pode definir usando a InterlacedRowsColor propriedade .

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

Quando IsDockedInsideChartArea é definido como False, a MaximumAutoSize propriedade define o tamanho máximo, em porcentagem, da legenda dentro do gráfico disponível quando a legenda é posicionada automaticamente. Essa propriedade deve ser definida se você quiser ajustar a largura ou a altura da legenda depois que as propriedades de encaixe tiverem sido definidas.

A legenda pode ser modificada usando o CustomizeLegend evento .

Construtores

Propriedades

Métodos

Aplica-se a