Chart.SetElement-Methode

Artikel
08/10/2011

Ändert ein Element im Diagramm.

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

Syntax

'Declaration
Sub SetElement ( _
    Element As MsoChartElementType _
)

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 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