Método Chart.SetElement

Artigo
01/09/2014

Altera um elemento no gráfico.

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

Sintaxe

'Declaração
Sub SetElement ( _
    Element As MsoChartElementType _
)

void SetElement(
    MsoChartElementType Element
)

Parâmetros

Element
Tipo: Microsoft.Office.Core.MsoChartElementType
Um dos valores de Microsoft.Office.Core.MsoChartElementType que especifica o tipo de alteração do elemento.

Comentários

Use o método de SetElement para alterar um elemento de gráfico de acordo com as opções especificadas pelos valores de Microsoft.Office.Core.MsoChartElementType . Por exemplo, para ocultar a legenda da tabela, passar o valor Microsoft.Office.Core.MsoChartElementType.msoElementLegendNone para o método de SetElement .

As operações que você pode executar usando esse método correspondem aos botões na guia de Layout de fita quando um gráfico é selecionado:

Todos os botões no grupo de Rótulos .
Todos os botões no grupo de Eixos .
Todos os botões no grupo de Análise .
Área de Plotagem, Parede do Gráfico, e botões de Base do Gráfico no grupo de Plano de Fundo .

Exemplos

O exemplo de código a seguir aplica o décimo layout que está disponível para o tipo de gráfico de gráfico de Chart_1 . Além disso, o exemplo usa o método de SetElement para aplicar alterações adicionais de layout: configurar o estilo de título do gráfico a ser centralizado e encontrado-se dentro da área de grade de gráfico, adicionando um título para o eixo horizontal, e adicione um título rotacionado para o eixo vertical. Para executar este exemplo de código, você deve adicionar um gráfico bidimensional de coluna clusterizado com o nome Chart_1 à folha padrão Sheet1.

Private Sub DesignChart()
    Dim myChart As Microsoft.Office.Tools.Excel.Chart = _
        Globals.Sheet1.Chart_1

    myChart.ApplyLayout(10)

    myChart.SetElement(Microsoft.Office.Core.MsoChartElementType. _
                       msoElementChartTitleCenteredOverlay)
    myChart.SetElement(Microsoft.Office.Core.MsoChartElementType. _
                       msoElementPrimaryCategoryAxisTitleHorizontal)
    myChart.SetElement(Microsoft.Office.Core.MsoChartElementType. _
                       msoElementPrimaryValueAxisTitleRotated)
End Sub

private void DesignChart()
{
    Microsoft.Office.Tools.Excel.Chart myChart =
        Globals.Sheet1.Chart_1;

    myChart.ApplyLayout(10, myChart.ChartType);

    myChart.SetElement(
        Microsoft.Office.Core.MsoChartElementType.
        msoElementChartTitleCenteredOverlay);
    myChart.SetElement(
        Microsoft.Office.Core.MsoChartElementType.
        msoElementPrimaryCategoryAxisTitleHorizontal);
    myChart.SetElement(
        Microsoft.Office.Core.MsoChartElementType.
        msoElementPrimaryValueAxisTitleRotated);
}

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ável.

Consulte também

Referência

Chart Interface

Namespace Microsoft.Office.Tools.Excel

Compartilhar via