Método ChartSheetBase.ApplyLayout

Artigo
01/09/2014

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
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. A guia 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 na planilha de gráfico Chart1. 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 esse exemplo de código, a pasta de trabalho deve conter uma planilha de gráfico bidimensional de coluna agrupada chamada 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ável.

Consulte também

Referência

ChartSheetBase Classe

Namespace Microsoft.Office.Tools.Excel

Compartilhar via