Metodo ChartSheetBase.ApplyLayout

Articolo
08/11/2011

Applica il layout specificato al grafico.

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

Sintassi

'Dichiarazione
Public Sub ApplyLayout ( _
    layout As Integer, _
    chartType As Object _
)

public 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 di grafico nel foglio grafico Chart1. 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, nella cartella di lavoro deve essere presente un foglio grafico con un istogramma bidimensionale raggruppato denominato 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);
}

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

ChartSheetBase Classe

Spazio dei nomi Microsoft.Office.Tools.Excel

Condividi tramite