ChartSheet.ApplyLayout(Int32, Object) Método

Referência

Definição

Namespace:: Microsoft.Office.Tools.Excel

Assemblies:: Microsoft.Office.Tools.Excel.dll, Microsoft.Office.Tools.Excel.v4.0.Utilities.dll

Importante

Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.

Aplica o layout especificado ao gráfico.

public void ApplyLayout (int Layout, object ChartType);

abstract member ApplyLayout : int * obj -> unit

Public Sub ApplyLayout (Layout As Integer, Optional ChartType As Object)

Parâmetros

Layout: Int32

Um inteiro de 1 a 10 que especifica o tipo de layout a ser aplicado no gráfico.

ChartType: Object

Um dos valores de XlChartType.

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 SetElement método para aplicar outras alterações de layout: definir o estilo do título do gráfico para ser centralizado e estar dentro da área de grade do gráfico, adicionar um título para o eixo horizontal e adicionar um título girado 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 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);
}

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

Comentários

Os valores do Layout parâmetro correspondem às opções disponíveis no grupo Layouts de Gráfico na guia Design da Faixa de Opções. A guia Design fica 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 das opções de layout de um gráfico de colunas. Se você quiser aplicar um layout de um tipo de gráfico diferente, poderá usar o ChartType parâmetro para especificar o tipo de gráfico ao qual o Layout parâmetro se referirá. Por exemplo, se você tiver um gráfico de colunas e quiser aplicar um layout de um gráfico de linhas, passe o Microsoft.Office.Interop.Excel.XlChartType.xlLine valor para o ChartType parâmetro . O layout adiciona apenas elementos de gráfico que estão disponíveis para esse tipo de gráfico específico.

Parâmetros Opcionais

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

Aplica-se a

Compartilhar via