Chart.PrintOut-Methode

  • Artikel

Druckt das Chart-Steuerelement.

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

Syntax

'Declaration
Sub PrintOut ( _
    From As Object, _
    To As Object, _
    Copies As Object, _
    Preview As Object, _
    ActivePrinter As Object, _
    PrintToFile As Object, _
    Collate As Object, _
    PrToFileName As Object _
)

void PrintOut(
    Object From,
    Object To,
    Object Copies,
    Object Preview,
    Object ActivePrinter,
    Object PrintToFile,
    Object Collate,
    Object PrToFileName
)

Parameter

  • From
    Typ: System.Object
    Die Nummer der ersten zu druckenden Seite.Wenn dieses Argument ausgelassen wird, startet der Druckvorgang am Anfang.
  • To
    Typ: System.Object
    Die Nummer der letzten zu druckenden Seite.Wenn dieses Argument ausgelassen wird, endet der Druckvorgang mit der letzten Seite.
  • Copies
    Typ: System.Object
    Die Anzahl der zu druckenden Exemplare.Wenn dieses Argument ausgelassen wird, wird ein Exemplar gedruckt.
  • Preview
    Typ: System.Object
    true, damit Microsoft Office Excel vor dem Drucken des Objekts die Seitenansicht aufruft.false (oder ausgelassen), um das Objekt sofort zu drucken.
  • ActivePrinter
    Typ: System.Object
    Legt den Namen des aktiven Druckers fest.
  • PrintToFile
    Typ: System.Object
    true, wenn in eine Datei gedruckt werden soll.Wenn PrToFileName nicht angegeben wird, fordert Excel den Benutzer zur Eingabe des Namens der Ausgabedatei auf.
  • Collate
    Typ: System.Object
    true, wenn mehrere Exemplare sortiert werden sollen.
  • PrToFileName
    Typ: System.Object
    Wenn PrintToFile auf true festgelegt ist, gibt dieses Argument den Namen der Datei an, in der die Ausgabe erfolgen soll.

Hinweise

Die Option “Seiten" in den Beschreibungen von From und To bezieht sich auf die gedruckten Seiten, nicht auf die allgemeinen Seiten im Blatt oder in der Arbeitsmappe.

Optionale Parameter

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

Beispiele

Im folgenden Codebeispiel wird ein Chart erstellt und anschließend die PrintOut-Methode verwendet, um zwei Kopien des Diagramms in einer Datei auszugeben.

Private Sub PrintChartToFile()
    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.SetSourceData(Me.Range("A1", "B5"), Excel.XlRowCol.xlColumns)
    Chart1.ChartType = Excel.XlChartType.xl3DColumn

    Chart1.PrintOut(Copies:=2, Preview:=True, PrintToFile:=True, _
        Collate:=False)
End Sub

private void PrintChartToFile()
{
    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.SetSourceData(this.Range["A1", "B5"], 
        Excel.XlRowCol.xlColumns);
    chart1.ChartType = Excel.XlChartType.xl3DColumn;

    chart1.PrintOut(missing, missing, 2, true, missing, 
        true, false, missing);
}

.NET Framework-Sicherheit

Siehe auch

Referenz

Chart Schnittstelle

Microsoft.Office.Tools.Excel-Namespace