Método Chart.SetElement

Artigo
08/01/2011

Modifica um elemento do 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
Dentre as Microsoft.Office.Core.MsoChartElementType valores que especifica o tipo de modificação do elemento.

Comentários

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

As operações que você pode executar usando esse método correspondem às seguintes botões na Layout guia da faixa de opções quando um gráfico é selecionado:

Todos os botões de rótulos grupo.
Todos os botões de eixos grupo.
Todos os botões de Analysis grupo.
O Área de plotagem, Parede do gráfico, e Base do gráfico botões na fundo grupo.

Exemplos

O exemplo de código a seguir aplica o layout de décimo está disponível para o tipo de gráfico da Chart_1 gráfico. Além disso, o exemplo usa o SetElement método para aplicar mais alterações de layout: Definindo o estilo do título do gráfico para ser centralizado e se encontram dentro da área de grade do gráfico, adicionando um título para o eixo horizontal e adicionando um título girado para o eixo vertical. Para executar este exemplo de código, você deve adicionar um gráfico de colunas agrupadas bidimensional com o nome Chart_1 para a planilha 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áveis.

Consulte também

Referência

Chart Interface

Namespace Microsoft.Office.Tools.Excel

Compartilhar via