Chart.ApplyLayout(Int32, Object) Methode

Referenz

Definition

Namespace:: Microsoft.Office.Tools.Excel

Assembly:: Microsoft.Office.Tools.Excel.dll

Wichtig

Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.

Übernimmt die auf dem Menüband angezeigten Layouts.

public void ApplyLayout (int Layout, object ChartType);

abstract member ApplyLayout : int * obj -> unit

Public Sub ApplyLayout (Layout As Integer, Optional ChartType As Object)

Parameter

Layout: Int32

Eine ganze Zahl von eins bis zehn gibt den Typ des für das Diagramm zu übernehmenden Typs an.

ChartType: Object

Einer der XlChartType-Werte.

Beispiele

Im folgenden Codebeispiel wird das zehnte Layout angewendet, das für den Diagrammtyp des Chart_1 Diagramms verfügbar ist. Darüber hinaus verwendet das Beispiel die SetElement -Methode, um weitere Layoutänderungen anzuwenden: Festlegen des Stils des Diagrammtitels auf zentriert und innerhalb des Diagrammrasterbereichs, Hinzufügen eines Titels für die horizontale Achse und Hinzufügen eines gedrehten Titels für die vertikale Achse. Zum Ausführen dieses Codebeispiels müssen Sie dem Standardblatt Sheet1ein gruppiertes zweidimensionales Spaltendiagramm mit dem Namen Chart_1 hinzufügen.

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);
}

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

Hinweise

Die Werte des Layout Parameters entsprechen den verfügbaren Optionen in der Gruppe Diagrammlayouts auf der Registerkarte Entwurf im Menüband. Die Registerkarte Entwurf ist verfügbar, wenn Sie ein Diagramm auswählen.

Jeder Diagrammtyp verfügt über eigene Layoutoptionen. Beispielsweise unterscheiden sich die Layoutoptionen für ein Kreisdiagramm von den Layoutoptionen für ein Säulendiagramm. Wenn Sie ein Layout aus einem anderen Diagrammtyp anwenden möchten, können Sie den ChartType -Parameter verwenden, um den Diagrammtyp anzugeben, auf den der Layout Parameter verweist. Wenn Sie beispielsweise über ein Säulendiagramm verfügen und ein Layout aus einem Liniendiagramm anwenden möchten, übergeben Sie den Microsoft.Office.Interop.Excel.XlChartType.xlLine Wert an den ChartType Parameter. Das Layout fügt nur Diagrammelemente hinzu, die für diesen bestimmten Diagrammtyp verfügbar sind.

Optionale Parameter

Informationen zu optionalen Parametern finden Sie unter Optionale Parameter in Office-Projektmappen.

Gilt für:

Freigeben über