Método Chart.ApplyLayout

Artigo
08/01/2011

Aplica os layouts mostrados na faixa de opções.

Namespace: Microsoft.Office.Tools.Excel
Assembly: Microsoft.Office.Tools.Excel (em Microsoft.Office.Tools.Excel.dll)

Sintaxe

'Declaração
Sub ApplyLayout ( _
    Layout As Integer, _
    ChartType As Object _
)

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 da Chart_1 gráfico. 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, você deve adicionar um gráfico de colunas agrupadas bidimensional com o nome Chart_1 para a planilha padrão Sheet1.

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

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);
}

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

Chart Interface

Namespace Microsoft.Office.Tools.Excel

Partilhar via