ChartSheet.ApplyLayout-Methode

Artikel
08/10/2011

Übernimmt das angegebene Layout für das Diagramm.

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 Diagramms in Diagrammblatt Chart1 verfügbare Layout verwendet. Darüber hinaus werden in diesem Beispiel mit der SetElement-Methode weitere Layoutänderungen angewendet: das Festlegen des Stils für den Diagrammtitel als zentriert und innerhalb des Diagrammrasterbereichs befindlich, das Hinzufügen eines Titels für die horizontale Achse und das Hinzufügen eines gedrehten Titels für die vertikale Achse. Um dieses Codebeispiel auszuführen, muss die Arbeitsmappe ein zweidimensionales Diagrammblatt mit einer gruppierten Spalte mit dem Namen Chart1 enthalten.

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

.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

ChartSheet Schnittstelle

Microsoft.Office.Tools.Excel-Namespace

Freigeben über