ChartSheetBase.SetElement-Methode

Artikel
08/10/2011

Ändert ein Element im Diagramm, das in ChartSheetBase angezeigt wird.

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

Syntax

'Declaration
Public Sub SetElement ( _
    element As MsoChartElementType _
)

public void SetElement(
    MsoChartElementType element
)

Parameter

element
Typ: Microsoft.Office.Core.MsoChartElementType
Einer der Microsoft.Office.Core.MsoChartElementType-Werte, der den Typ der Elementänderung angibt.

Hinweise

Verwenden Sie die SetElement-Methode, um ein Element des Diagramms gemäß den von den Microsoft.Office.Core.MsoChartElementType-Werten angegebenen Optionen zu ändern. Soll beispielsweise eine Tabellenlegende ausgeblendet werden, übergeben Sie den Wert Microsoft.Office.Core.MsoChartElementType.msoElementLegendNone der SetElement-Methode.

Die mit dieser Methode durchführbaren Vorgänge entsprechen den folgenden Schaltflächen auf der Registerkarte Layout des Menübands bei Auswahl eines Diagramms:

Alle Schaltflächen der Gruppe Bezeichnungen.
Alle Schaltflächen der Gruppe Achsen.
Alle Schaltflächen der Gruppe Analyse.
Die Schaltflächen Bereich zeichnen, Diagrammwand und Diagrammboden in der Gruppe Hintergrund.

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

ChartSheetBase Klasse

Microsoft.Office.Tools.Excel-Namespace

Freigeben über