Metodo Chart.ApplyLayout

Articolo
08/11/2011

Applica i layout visualizzati nella barra multifunzione.

Spazio dei nomi: Microsoft.Office.Tools.Excel
Assembly: Microsoft.Office.Tools.Excel (in Microsoft.Office.Tools.Excel.dll)

Sintassi

'Dichiarazione
Sub ApplyLayout ( _
    Layout As Integer, _
    ChartType As Object _
)

void ApplyLayout(
    int Layout,
    Object ChartType
)

Parametri

Layout
Tipo: System.Int32
Numero intero compreso tra 1 e 10 che specifica il tipo di layout da applicare al grafico.

ChartType
Tipo: System.Object
Uno dei valori Microsoft.Office.Interop.Excel.XlChartType.

Note

I valori del parametro Layout corrispondono alle opzioni disponibili nel gruppo Stili del grafico della scheda Progettazione nella barra multifunzione. La scheda Progettazione è disponibile quando si seleziona un grafico.

Ciascun tipo di grafico dispone di un proprio set di opzioni di layout. Le opzioni di layout per un grafico a torta, ad esempio, sono diverse da quelle relative a un istogramma. Per applicare un layout relativo a un tipo di grafico diverso, utilizzare il parametro ChartType per specificare il tipo di grafico cui il parametro Layout fa riferimento. Ad esempio, per applicare a un istogramma un layout relativo a un grafico a linee, passare il valore XlChartType.xlLine al parametro ChartType. Il layout aggiunge soltanto gli elementi del grafico disponibili per quel particolare tipo di grafico.

Parametri facoltativi

Per informazioni sui parametri facoltativi, vedere Parametri facoltativi nelle soluzioni Office.

Esempi

Nell'esempio di codice seguente viene applicato il decimo layout disponibile per il tipo del grafico Chart_1. Inoltre, nell'esempio viene utilizzato il metodo SetElement per applicare ulteriori modifiche di layout: impostazione dello stile del titolo del grafico affinché sia allineato al centro e si trovi all'interno dell'area della griglia del grafico, aggiunta di un titolo per l'asse orizzontale e aggiunta di un titolo ruotato per l'asse verticale. Per eseguire questo esempio di codice, è necessario aggiungere un istogramma bidimensionale raggruppato denominato Chart_1 al foglio predefinito 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);
}

Sicurezza di .NET Framework

Attendibilità totale per il chiamante immediato. Impossibile utilizzare questo membro in codice parzialmente attendibile. Per ulteriori informazioni, vedere Utilizzo di librerie da codice parzialmente attendibile.

Vedere anche

Riferimenti

Chart Interfaccia

Spazio dei nomi Microsoft.Office.Tools.Excel

Condividi tramite