Chart.ApplyLayout-Methode

Artikel
08/10/2011

Übernimmt die auf dem Menüband angezeigten Layouts.

Namespace: Microsoft.Office.Tools.Excel
Assembly: Microsoft.Office.Tools.Excel (in Microsoft.Office.Tools.Excel.dll)

Syntax

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

void ApplyLayout(
    int Layout,
    Object ChartType
)

Parameter

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

ChartType
Typ: System.Object
Einer der Microsoft.Office.Interop.Excel.XlChartType-Werte.

Hinweise

Die Werte des Layout-Parameters entsprechen den verfügbaren Optionen in der Gruppe Diagrammlayouts auf der Registerkarte Entwurf des Menübands. Die Registerkarte Entwurf ist beim Auswählen eines Diagramms verfügbar.

Für jeden Diagrammtyp sind individuelle Layoutoptionen verfügbar. Beispielsweise unterscheiden sich die Layoutoptionen für ein Tortendiagramm von den Optionen für ein Säulendiagramm. Wenn Sie ein Layout von einem anderen Diagrammtyp übernehmen möchten, können Sie mit dem ChartType-Parameter den Diagrammtyp angeben, auf den sich der Layout-Parameter bezieht. Sofern Sie beispielsweise für ein Säulendiagramm ein Layout von einem Liniendiagramm übernehmen möchten, übergeben Sie dem ChartType-Parameter den XlChartType.xlLine-Wert. Das Layout fügt lediglich Diagrammelemente hinzu, die für diesen bestimmten Diagrammtyp verfügbar sind.

Optionale Parameter

Weitere Informationen zu optionalen Parametern finden Sie unter Optionale Parameter in Office-Lösungen.

Beispiele

Im folgenden Codebeispiel wird das zehnte für den Diagrammtyp des Chart_1-Diagramms verfügbare Layout angewendet. Darüber hinaus werden in diesem Beispiel mit der SetElement-Methode weitere Layoutänderungen angewendet: Der Stil für den Diagrammtitel wird als zentriert und innerhalb des Diagrammrasterbereichs befindlich festgelegt, ein Titel für die horizontale Achse wird hinzugefügt, und der vertikalen Achse wird ein gedrehter Titel hinzugefügt. Um dieses Codebeispiel ausführen zu können, müssen Sie dem Standardarbeitsblatt Sheet1 ein zweidimensionales gruppiertes Säulendiagramm mit dem Namen Chart_1 hinzufügen.

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

.NET Framework-Sicherheit

Volle Vertrauenswürdigkeit für den unmittelbaren Aufrufer. Dieser Member kann von nur teilweise vertrauenswürdigem Code nicht verwendet werden. Weitere Informationen finden Sie unter Verwenden von Bibliotheken aus teilweise vertrauenswürdigem Code.

Siehe auch

Referenz

Chart Schnittstelle

Microsoft.Office.Tools.Excel-Namespace

Freigeben über