Chart.ChartWizard-Methode

Artikel
08/10/2011

Ändert die Eigenschaften des angegebenen Chart-Steuerelements. Sie können diese Methode verwenden, um ein Chart-Steuerelement schnell zu formatieren, ohne alle einzelnen Eigenschaften festlegen zu müssen. Diese Methode ist nicht interaktiv und ändert nur die angegebenen Eigenschaften.

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

Syntax

'Declaration
Sub ChartWizard ( _
    Source As Object, _
    Gallery As Object, _
    Format As Object, _
    PlotBy As Object, _
    CategoryLabels As Object, _
    SeriesLabels As Object, _
    HasLegend As Object, _
    Title As Object, _
    CategoryTitle As Object, _
    ValueTitle As Object, _
    ExtraTitle As Object _
)

void ChartWizard(
    Object Source,
    Object Gallery,
    Object Format,
    Object PlotBy,
    Object CategoryLabels,
    Object SeriesLabels,
    Object HasLegend,
    Object Title,
    Object CategoryTitle,
    Object ValueTitle,
    Object ExtraTitle
)

Parameter

Source
Typ: System.Object
Der Bereich, der die Quelldaten für das neue Diagramm enthält.Wenn dieses Argument ausgelassen wird, wird in Microsoft Office Excel das aktive Diagrammblatt oder das ausgewählte Chart-Steuerelement auf dem aktiven Arbeitsblatt bearbeitet.

Gallery
Typ: System.Object
XlChartType.Der Diagrammtyp.

Format
Typ: System.Object
Die Optionsnummer für die integrierten automatischen Formatierungen.Kann je nach Sammlungstyp eine Zahl von 1 bis 10 sein.Wenn dieses Argument ausgelassen wird, wählt Excel einen Standardwert auf Grundlage des Sammlungstyps und der Datenquelle.

PlotBy
Typ: System.Object
Gibt an, ob die Daten für jede Reihe in Zeilen oder Spalten angeordnet werden.Kann eine der folgenden XlRowCol-Konstanten sein: xlRows oder xlColumns.

CategoryLabels
Typ: System.Object
Eine ganze Zahl, die die Anzahl der Zeilen oder Spalten mit Rubrikenbeschriftungen im Quellbereich angibt.Gültige Werte sind von 0 (null) zur maximalen Anzahl der entsprechenden Kategorien oder Reihen minus eins.

SeriesLabels
Typ: System.Object
Eine ganze Zahl, die die Anzahl der Zeilen oder Spalten mit Reihenbeschriftungen im Quellbereich angibt.Gültige Werte sind von 0 (null) zur maximalen Anzahl der entsprechenden Kategorien oder Reihen minus eins.

HasLegend
Typ: System.Object
true, um eine Legende hinzuzufügen.

Title
Typ: System.Object
Der Titeltext des Chart-Steuerelements.

CategoryTitle
Typ: System.Object
Der Rubrikenachsentiteltext.

ValueTitle
Typ: System.Object
Der Wertachsentiteltext

ExtraTitle
Typ: System.Object
Der Reihenachsentitel für 3D-Diagramme oder der zweite Wertachsentitel für 2D-Diagramme.

Hinweise

Wenn Source ausgelassen wird und es sich bei der Auswahl nicht um ein eingebettetes Diagramm im aktiven Arbeitsblatt handelt oder das aktive Blatt kein bestehendes Diagramm ist, schlägt diese Methode fehl und es tritt ein Fehler auf.

Optionale Parameter

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

Beispiele

Im folgenden Codebeispiel wird die ChartWizard-Methode verwendet, um ein 3D-Säulendiagramm zu erstellen, mit dem die Datenreihen im Bereich der Zellen A1 bis B5 angezeigt werden.

Private Sub Create3DColumnChart()
    Me.Range("A1", "A5").Value2 = 22
    Me.Range("B1", "B5").Value2 = 55

    Dim Chart1 As Microsoft.Office.Tools.Excel.Chart = _
        Me.Controls.AddChart(Me.Range("D2", "H12"), "Chart1")

    Chart1.ChartWizard(Me.Range("A1", "B5"), _
        Excel.XlChartType.xl3DColumn, PlotBy:=Excel.XlRowCol.xlColumns)
End Sub

private void Create3DColumnChart()
{
    this.Range["A1", "A5"].Value2 = 22;
    this.Range["B1", "B5"].Value2 = 55;

    Microsoft.Office.Tools.Excel.Chart chart1 =
        this.Controls.AddChart(this.Range["D2", "H12"], 
        "chart1");

    chart1.ChartWizard(this.Range["A1", "B5"], 
        Excel.XlChartType.xl3DColumn, missing, 
        Excel.XlRowCol.xlColumns, missing, missing, missing,
        missing, missing, missing, missing);
}

.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