Método ChartSheetBase.SetElement

Artigo
08/01/2011

Modifica um elemento em que é exibido no gráfico a 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
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 do gráfico na folha de gráfico Chart1. 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, a sua pasta de trabalho deve conter uma planilha de gráfico bidimensional de colunas agrupadas denominada 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áveis.

Consulte também

Referência

ChartSheetBase Classe

Namespace Microsoft.Office.Tools.Excel

Compartilhar via