Método ChartSheetBase.ApplyLayout

Artigo
08/01/2011

Aplica o layout especificado para o gráfico.

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 ApplyLayout ( _
    layout As Integer, _
    chartType As Object _
)

public void ApplyLayout(
    int layout,
    Object chartType
)

Parâmetros

layout
Tipo: System.Int32
Um inteiro de 1 a 10 que especifica o tipo de layout para aplicar ao gráfico.

chartType
Tipo: System.Object
Dentre as Microsoft.Office.Interop.Excel.XlChartType valores.

Comentários

Os valores da Layout parâmetro correspondem às opções disponíveis na Layouts de gráfico grupo de Design guia na faixa. O Design guia está disponível quando você seleciona um gráfico.

Cada tipo de gráfico tem seu próprio conjunto de opções de layout. Por exemplo, as opções de layout para um gráfico de pizza são diferentes entre as opções de layout para um gráfico de colunas. Se você deseja aplicar um layout de um tipo de gráfico diferente, você pode usar o ChartType tipo de parâmetro para especificar o gráfico que o Layout parâmetro se referirá a. Por exemplo, se você tiver um gráfico de colunas e você deseja aplicar um layout de um gráfico de linha, passe o XlChartType.xlLine valor para o ChartType parâmetro. O layout apenas adiciona elementos de gráfico que estão disponíveis para esse tipo de gráfico específico.

Optional Parameters

Para obter informações sobre os parâmetros opcionais, consulte Parâmetros opcionais em soluções do Office.

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