Método ChartSheet.ApplyLayout

Artigo
05/21/2013

Aplica o layout especificado para o gráfico.

Namespace: Microsoft.Office.Tools.Excel
Assemblies: Microsoft.Office.Tools.Excel.v4.0.Utilities (em Microsoft.Office.Tools.Excel.v4.0.Utilities.dll)
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 Layouts 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 deseje 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 de layout que está disponível para o tipo de elemento gráfico de gráfico na folha Chart1de gráfico.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, sua pasta de trabalho deve conter uma folha bidimensional do elemento gráfico da coluna clusterizado 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áveis.

Consulte também

Referência

ChartSheet Interface

Namespace Microsoft.Office.Tools.Excel

Compartilhar via