Método ChartSheetBase.SetElement

Artigo
05/21/2013

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 o título da tabela, passar o valor Microsoft.Office.Core.MsoChartElementType.msoElementLegendNone para o método de SetElement .

As operações que você pode realizar 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 de layout que está disponível para o tipo de elemento gráfico de gráfico na folha Chart1de gráfico.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, sua pasta de trabalho deve conter uma folha bidimensional do elemento gráfico da coluna clusterizado 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áveis.

Consulte também

Referência

ChartSheetBase Classe

Namespace Microsoft.Office.Tools.Excel

Compartilhar via