Método Chart.ApplyDataLabels

Artigo
08/01/2011

Aplica rótulos de dados para um ponto, uma série ou todas as séries em um Chart de controle.

Namespace: Microsoft.Office.Tools.Excel
Assembly: Microsoft.Office.Tools.Excel (em Microsoft.Office.Tools.Excel.dll)

Sintaxe

'Declaração
Sub ApplyDataLabels ( _
    Type As XlDataLabelsType, _
    LegendKey As Object, _
    AutoText As Object, _
    HasLeaderLines As Object, _
    ShowSeriesName As Object, _
    ShowCategoryName As Object, _
    ShowValue As Object, _
    ShowPercentage As Object, _
    ShowBubbleSize As Object, _
    Separator As Object _
)

void ApplyDataLabels(
    XlDataLabelsType Type,
    Object LegendKey,
    Object AutoText,
    Object HasLeaderLines,
    Object ShowSeriesName,
    Object ShowCategoryName,
    Object ShowValue,
    Object ShowPercentage,
    Object ShowBubbleSize,
    Object Separator
)

Parâmetros

Type
Tipo: Microsoft.Office.Interop.Excel.XlDataLabelsType
XlDataLabelsType .O tipo de rótulo de dados para aplicar.

LegendKey
Tipo: System.Object
true para mostrar o código da legenda próxima ao ponto.O valor padrão é false.

AutoText
Tipo: System.Object
true Se o objeto gera automaticamente o texto apropriado com base no conteúdo.

HasLeaderLines
Tipo: System.Object
Para o Chart e Series objetos, true se a série tiver linhas de preenchimento.

ShowSeriesName
Tipo: System.Object
O nome da série para o rótulo de dados.

ShowCategoryName
Tipo: System.Object
O nome de categoria para o rótulo de dados.

ShowValue
Tipo: System.Object
O valor para o rótulo de dados.

ShowPercentage
Tipo: System.Object
A porcentagem para o rótulo de dados.

ShowBubbleSize
Tipo: System.Object
O tamanho da bolha para o rótulo de dados.

Separator
Tipo: System.Object
O separador do rótulo de dados.

Comentários

Optional Parameters

Para obter informações sobre os parâmetros opcionais, consulte Parâmetros opcionais em soluções do Office.

Exemplos

O exemplo de código a seguir cria um Chart e, em seguida, usa o ApplyDataLabels método para exibir os rótulos de dados com os nomes de séries no gráfico.

Private Sub DisplayLabels()
    Me.Range("A1", "A5").Value2 = 22
    Me.Range("B1", "B5").Value2 = 55

    Dim Chart1 As Microsoft.Office.Tools.Excel.Chart = _
        Me.Controls.AddChart(Me.Range("D2", "H20"), "Chart1")

    Chart1.SetSourceData(Me.Range("A1", "B5"), Excel.XlRowCol.xlColumns)
    Chart1.ChartType = Excel.XlChartType.xlBarClustered

    Chart1.ApplyDataLabels(Excel.XlDataLabelsType.xlDataLabelsShowLabel, _
        False, False, False, True, False, False, False, False, False)
End Sub

private void DisplayLabels()
{
    this.Range["A1", "A5"].Value2 = 22;
    this.Range["B1", "B5"].Value2 = 55;

    Microsoft.Office.Tools.Excel.Chart chart1 =
        this.Controls.AddChart(this.Range["D2", "H20"], 
        "chart1");

    chart1.SetSourceData(this.Range["A1", "B5"], 
        Excel.XlRowCol.xlColumns);
    chart1.ChartType = Excel.XlChartType.xlBarClustered;

    chart1.ApplyDataLabels(
        Excel.XlDataLabelsType.xlDataLabelsShowLabel,
        false, false, false, true, false, false, false, 
        false, false);
}

Segurança do .NET Framework

Confiança total para o chamador imediato. O membro não pode ser usado por código parcialmente confiável. Para obter mais informações, consulte Usando bibliotecas de código parcialmente confiáveis.

Consulte também

Referência

Chart Interface

Namespace Microsoft.Office.Tools.Excel

Partilhar via