Método Chart.ApplyLayout

Artigo
01/09/2014

Aplica os layouts mostrados em fita.

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
Um dos valores de Microsoft.Office.Interop.Excel.XlChartType.

Comentários

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

Cada tipo de elemento 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 opções de layout para um gráfico de coluna. Se você deseja aplicar um layout de um tipo diferente de gráfico, você pode usar o parâmetro de ChartType para especificar o tipo de elemento gráfico que o parâmetro de Layout referirá. Por exemplo, se você tiver um gráfico de coluna e querer aplicar um layout de um gráfico de linhas, passar o valor de XlChartType.xlLine para o parâmetro de ChartType . O layout adiciona somente os elementos do elemento gráfico que estão disponíveis para esse tipo específico de gráfico.

Parâmetros Opcionais

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

Exemplos

O exemplo de código a seguir aplica o décimo layout que está disponível para o tipo de gráfico de gráfico de Chart_1 . 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, você deve adicionar um gráfico bidimensional de coluna clusterizado com o nome Chart_1 à folha 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ável.

Consulte também

Referência

Chart Interface

Namespace Microsoft.Office.Tools.Excel

Compartilhar via