Chart.ApplyLayout(Int32, Object) Método

Referência

Definição

Namespace:: Microsoft.Office.Tools.Excel

Assembly:: Microsoft.Office.Tools.Excel.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 os layouts mostrados na Faixa de Opções.

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 disponível para o tipo de gráfico do Chart_1 gráfico. 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 este exemplo de código, você deve adicionar um gráfico bidimensional de coluna clusterizado com o nome Chart_1 à planilha Sheet1padrão .

private void DesignChart()
{
    Microsoft.Office.Tools.Excel.Chart myChart =
        Globals.Sheet1.Chart_1;

    myChart.ApplyLayout(10, myChart.ChartType);

    myChart.SetElement(
        Microsoft.Office.Core.MsoChartElementType.
        msoElementChartTitleCenteredOverlay);
    myChart.SetElement(
        Microsoft.Office.Core.MsoChartElementType.
        msoElementPrimaryCategoryAxisTitleHorizontal);
    myChart.SetElement(
        Microsoft.Office.Core.MsoChartElementType.
        msoElementPrimaryValueAxisTitleRotated);
}

Private Sub DesignChart()
    Dim myChart As Microsoft.Office.Tools.Excel.Chart = _
        Globals.Sheet1.Chart_1

    myChart.ApplyLayout(10)

    myChart.SetElement(Microsoft.Office.Core.MsoChartElementType. _
                       msoElementChartTitleCenteredOverlay)
    myChart.SetElement(Microsoft.Office.Core.MsoChartElementType. _
                       msoElementPrimaryCategoryAxisTitleHorizontal)
    myChart.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 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 de 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 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