Método ChartSheetBase.SetElement

Artigo
01/09/2014

Altera um elemento no elemento gráfico que é exibido em ChartSheetBase.

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

Sintaxe

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

public 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 na planilha de gráfico Chart1. 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 esse exemplo de código, a pasta de trabalho deve conter uma planilha de gráfico bidimensional de coluna agrupada chamada Chart1.

Private Sub DesignChartSheet()
    Dim myChartSheet As Microsoft.Office.Tools.Excel.ChartSheet = _
        Globals.Chart1.Base

    myChartSheet.ApplyLayout(10)

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

private void DesignChartSheet()
{
    Microsoft.Office.Tools.Excel.ChartSheet myChartSheet  =
        Globals.Chart1.Base;

    myChartSheet.ApplyLayout(10, myChartSheet.ChartType);

    myChartSheet.SetElement(Microsoft.Office.Core.MsoChartElementType.
                       msoElementChartTitleCenteredOverlay);
    myChartSheet.SetElement(Microsoft.Office.Core.MsoChartElementType.
                       msoElementPrimaryCategoryAxisTitleHorizontal);
    myChartSheet.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

ChartSheetBase Classe

Namespace Microsoft.Office.Tools.Excel

Compartilhar via