PrintQueue.CreateXpsDocumentWriter Methode

Definition

Namespace:

System.Printing

Assembly:

System.Printing.dll

Sie erstellt ein XpsDocumentWriter-Objekt.

Überlädt

CreateXpsDocumentWriter(PrintDocumentImageableArea, PageRangeSelection, PageRange)	Erstellt ein XpsDocumentWriter-Objekt, öffnet einen Windows-Standarddruckdialog, an den Seitenbereich und Auftragsbeschreibung übergeben werden, und gibt einen ref-Parameter (ByRef in Visual Basic) zurück, der Informationen zum Druckbereich und den Abmessungen des Mediums darstellt.
CreateXpsDocumentWriter(PrintDocumentImageableArea)	Erstellt ein XpsDocumentWriter-Objekt, öffnet einen Windows-Standarddruckdialog und gibt einen ref-Parameter (ByRef in Visual Basic) zurück, der Informationen zum Druckbereich und den Abmessungen des Mediums darstellt.
CreateXpsDocumentWriter(PrintQueue)	Erstellt ein XpsDocumentWriter-Objekt und weist es der angegebenen Druckwarteschlange zu.
CreateXpsDocumentWriter(Double, Double)	Erstellt ein XpsDocumentWriter-Objekt mit den angegebenen Abmessungen.
CreateXpsDocumentWriter(String, PrintDocumentImageableArea)	Erstellt ein XpsDocumentWriter-Objekt, öffnet einen Windows-Standarddruckdialog (an den die Auftragsbeschreibung übergeben wird) und gibt einen ref-Parameter (ByRef in Visual Basic) zurück, der Informationen zum Druckbereich und den Abmessungen des Mediums darstellt.
CreateXpsDocumentWriter(String, PrintDocumentImageableArea, PageRangeSelection, PageRange)	Erstellt ein XpsDocumentWriter-Objekt, öffnet einen Windows-Standarddruckdialog, an den ein Seitenbereich übergeben wird, und gibt einen ref-Parameter (ByRef in Visual Basic) zurück, der Informationen zum Druckbereich und den Abmessungen des Mediums darstellt.

CreateXpsDocumentWriter(PrintDocumentImageableArea, PageRangeSelection, PageRange)

Erstellt ein XpsDocumentWriter-Objekt, öffnet einen Windows-Standarddruckdialog, an den Seitenbereich und Auftragsbeschreibung übergeben werden, und gibt einen ref-Parameter (ByRef in Visual Basic) zurück, der Informationen zum Druckbereich und den Abmessungen des Mediums darstellt.

public:
 static System::Windows::Xps::XpsDocumentWriter ^ CreateXpsDocumentWriter(System::Printing::PrintDocumentImageableArea ^ % documentImageableArea, System::Windows::Controls::PageRangeSelection % pageRangeSelection, System::Windows::Controls::PageRange % pageRange);

public static System.Windows.Xps.XpsDocumentWriter CreateXpsDocumentWriter (ref System.Printing.PrintDocumentImageableArea documentImageableArea, ref System.Windows.Controls.PageRangeSelection pageRangeSelection, ref System.Windows.Controls.PageRange pageRange);

static member CreateXpsDocumentWriter : PrintDocumentImageableArea * PageRangeSelection * PageRange -> System.Windows.Xps.XpsDocumentWriter

Public Shared Function CreateXpsDocumentWriter (ByRef documentImageableArea As PrintDocumentImageableArea, ByRef pageRangeSelection As PageRangeSelection, ByRef pageRange As PageRange) As XpsDocumentWriter

Parameter

documentImageableArea

PrintDocumentImageableArea

Ein Verweis auf ein Objekt, das die Abmessungen des Seitenbereichs angibt, in dem das Gerät drucken kann. Da der Datentyp über keinen öffentlichen Konstruktor verfügt, wird dieser Parameter nicht initialisiert übergeben.

pageRangeSelection

PageRangeSelection

Ein Wert, der angibt, ob alle Seiten gedruckt werden oder nur ein vom Benutzer ausgewählter Seitenbereich.

pageRange

PageRange

Der zu druckende Seitenbereich.

Gibt zurück

XpsDocumentWriter

Ein XpsDocumentWriter, der XPS-Daten in einen Stream schreibt. Dieser Wert kann null sein. (Die Parameter documentImageableArea, pageRangeSelection und pageRange sind alle ref-Parameter [ByRef in Visual Basic], die vom Benutzer initialisiert und beim Schließen des Dialogfelds zurückgegeben werden. Damit stellt jeder Parameter einen zusätzlichen Rückgabewert dar.)

Hinweise

Viele Drucker benötigen bis zu einem Viertel eines Zolls unbedruckten Platz an den Rändern jeder Seite, um das Papier zu greifen und durch den Drucker zu bewegen. Andernfalls würde Der Toner den Papierflussmechanismus verletzen. Der Bereich, der gedruckt werden kann, ist der "bildbare Bereich".

Der Typ PrintDocumentImageableArea verfügt über keinen öffentlichen Konstruktor. Daher muss die Variable documentImageableArea deklariert und zugewiesen null werden und erst dann an die -Methode übergeben werden. Diese Methode zeigt eine PrintDialog vom Benutzer erforderliche Eingabe an. Der Benutzer konfiguriert seinen Druckauftrag im Dialogfeld (einschließlich Auswahl eines Druckers, Papierformats, Ausrichtung und Seitenbereichs). Wenn das Dialogfeld geschlossen ist und pageRangeSelectionpageRange Werte aufweist und documentImageableArea auf ein tatsächliches Objekt verweist, dessen Eigenschaften initialisiert werden.

Wenn der Benutzer das Dialogfeld abbricht oder schließt, ist nullder Rückgabewert . Daher muss der Rückgabewert von Ihrer Anwendung überprüft null werden.

Weitere Informationen

• isXPS-Konformitätstool

CreateXpsDocumentWriter(PrintDocumentImageableArea)

Erstellt ein XpsDocumentWriter-Objekt, öffnet einen Windows-Standarddruckdialog und gibt einen ref-Parameter (ByRef in Visual Basic) zurück, der Informationen zum Druckbereich und den Abmessungen des Mediums darstellt.

public:
 static System::Windows::Xps::XpsDocumentWriter ^ CreateXpsDocumentWriter(System::Printing::PrintDocumentImageableArea ^ % documentImageableArea);

public static System.Windows.Xps.XpsDocumentWriter CreateXpsDocumentWriter (ref System.Printing.PrintDocumentImageableArea documentImageableArea);

static member CreateXpsDocumentWriter : PrintDocumentImageableArea -> System.Windows.Xps.XpsDocumentWriter

Public Shared Function CreateXpsDocumentWriter (ByRef documentImageableArea As PrintDocumentImageableArea) As XpsDocumentWriter

Parameter

documentImageableArea

PrintDocumentImageableArea

Ein Verweis auf ein Objekt, das die Abmessungen des Seitenbereichs angibt, in dem das Gerät drucken kann. Da der Datentyp über keinen öffentlichen Konstruktor verfügt, wird dieser Parameter nicht initialisiert übergeben.

Gibt zurück

XpsDocumentWriter

Ein XpsDocumentWriter, der XPS-Daten in einen Stream schreibt. Dieser Wert kann null sein. (Der Parameter documentImageableArea ist ein ref-Parameter [ByRef in Visual Basic], der durch die Methode initialisiert wird und damit einen zweiten Rückgabewert darstellt.)

Hinweise

Viele Drucker benötigen bis zu einem Viertel eines Zolls unbedruckten Platz an den Rändern jeder Seite, um das Papier zu greifen und durch den Drucker zu bewegen. Andernfalls würde Der Toner den Papierflussmechanismus verletzen. Der Bereich, der gedruckt werden kann, ist der "bildbare Bereich".

Der Typ PrintDocumentImageableArea verfügt über keinen öffentlichen Konstruktor. Daher muss die Variable documentImageableArea deklariert und zugewiesen null werden und erst dann an die -Methode übergeben werden. Diese Methode zeigt eine PrintDialog vom Benutzer erforderliche Eingabe an. Nachdem der Benutzer einen Drucker, ein Papierformat und eine Ausrichtung ausgewählt und den Dialog geschlossen hat, zeigt auf ein tatsächliches Objekt, documentImageableArea und die zugehörigen Eigenschaften werden initialisiert.

Wenn der Benutzer das Dialogfeld abbricht oder schließt, ist nullder Rückgabewert . Daher muss der Rückgabewert von Ihrer Anwendung überprüft null werden.

Weitere Informationen

• isXPS-Konformitätstool

CreateXpsDocumentWriter(PrintQueue)

Erstellt ein XpsDocumentWriter-Objekt und weist es der angegebenen Druckwarteschlange zu.

public:
 static System::Windows::Xps::XpsDocumentWriter ^ CreateXpsDocumentWriter(System::Printing::PrintQueue ^ printQueue);

public static System.Windows.Xps.XpsDocumentWriter CreateXpsDocumentWriter (System.Printing.PrintQueue printQueue);

static member CreateXpsDocumentWriter : System.Printing.PrintQueue -> System.Windows.Xps.XpsDocumentWriter

Public Shared Function CreateXpsDocumentWriter (printQueue As PrintQueue) As XpsDocumentWriter

Parameter

printQueue

PrintQueue

Eine Druckwarteschlange, an die das XPS-Dokument übertragen wird.

Gibt zurück

XpsDocumentWriter

Ein XpsDocumentWriter, der in einen XPS-Stream schreibt.

Beispiele

Das folgende Beispiel zeigt, wie Sie diese Methode verwenden, um eine XpsDocumentWriterzu erstellen.

// -------------------- GetPrintXpsDocumentWriter() -------------------
/// <summary>
///   Returns an XpsDocumentWriter for the default print queue.</summary>
/// <returns>
///   An XpsDocumentWriter for the default print queue.</returns>
private XpsDocumentWriter GetPrintXpsDocumentWriter()
{
    // Create a local print server
    LocalPrintServer ps = new LocalPrintServer();

    // Get the default print queue
    PrintQueue pq = ps.DefaultPrintQueue;

    // Get an XpsDocumentWriter for the default print queue
    XpsDocumentWriter xpsdw = PrintQueue.CreateXpsDocumentWriter(pq);
    return xpsdw;
}// end:GetPrintXpsDocumentWriter()

' -------------------- GetPrintXpsDocumentWriter() -------------------
''' <summary>
'''   Returns an XpsDocumentWriter for the default print queue.</summary>
''' <returns>
'''   An XpsDocumentWriter for the default print queue.</returns>
Private Function GetPrintXpsDocumentWriter() As XpsDocumentWriter
    ' Create a local print server
    Dim ps As New LocalPrintServer()

    ' Get the default print queue
    Dim pq As PrintQueue = ps.DefaultPrintQueue

    ' Get an XpsDocumentWriter for the default print queue
    Dim xpsdw As XpsDocumentWriter = PrintQueue.CreateXpsDocumentWriter(pq)
    Return xpsdw
End Function ' end:GetPrintXpsDocumentWriter()

Weitere Informationen

• isXPS-Konformitätstool

CreateXpsDocumentWriter(Double, Double)

Erstellt ein XpsDocumentWriter-Objekt mit den angegebenen Abmessungen.

public:
 static System::Windows::Xps::XpsDocumentWriter ^ CreateXpsDocumentWriter(double % width, double % height);

public static System.Windows.Xps.XpsDocumentWriter CreateXpsDocumentWriter (ref double width, ref double height);

static member CreateXpsDocumentWriter : double * double -> System.Windows.Xps.XpsDocumentWriter

Public Shared Function CreateXpsDocumentWriter (ByRef width As Double, ByRef height As Double) As XpsDocumentWriter

Parameter

width

Double

Die Breite des XPS-Dokuments.

height

Double

Die Höhe des XPS-Dokuments.

Gibt zurück

XpsDocumentWriter

Ein XpsDocumentWriter, der in einen XPS-Stream schreibt. Dieser Wert kann null sein.

Hinweise

Diese Methode zeigt eine PrintDialog vom Benutzer erforderliche Eingabe an. Wenn der Benutzer das Dialogfeld abbricht oder schließt, ist nullder Rückgabewert . Daher muss der Rückgabewert von Ihrer Anwendung überprüft null werden.

Weitere Informationen

• isXPS-Konformitätstool

CreateXpsDocumentWriter(String, PrintDocumentImageableArea)

Erstellt ein XpsDocumentWriter-Objekt, öffnet einen Windows-Standarddruckdialog (an den die Auftragsbeschreibung übergeben wird) und gibt einen ref-Parameter (ByRef in Visual Basic) zurück, der Informationen zum Druckbereich und den Abmessungen des Mediums darstellt.

public:
 static System::Windows::Xps::XpsDocumentWriter ^ CreateXpsDocumentWriter(System::String ^ jobDescription, System::Printing::PrintDocumentImageableArea ^ % documentImageableArea);

public static System.Windows.Xps.XpsDocumentWriter CreateXpsDocumentWriter (string jobDescription, ref System.Printing.PrintDocumentImageableArea documentImageableArea);

static member CreateXpsDocumentWriter : string * PrintDocumentImageableArea -> System.Windows.Xps.XpsDocumentWriter

Public Shared Function CreateXpsDocumentWriter (jobDescription As String, ByRef documentImageableArea As PrintDocumentImageableArea) As XpsDocumentWriter

Parameter

jobDescription

String

Ein Name für den Druckauftrag. Der Name wird in der Druckbenutzeroberfläche von Windows angezeigt.

documentImageableArea

PrintDocumentImageableArea

Ein Verweis auf ein Objekt, das die Abmessungen des Seitenbereichs angibt, in dem das Gerät drucken kann. Da der Datentyp über keinen öffentlichen Konstruktor verfügt, wird dieser Parameter nicht initialisiert übergeben.

Gibt zurück

XpsDocumentWriter

Ein XpsDocumentWriter, der XPS-Daten in einen Stream schreibt. Dieser Wert kann null sein. (Der Parameter documentImageableArea ist ein ref-Parameter [ByRef in Visual Basic], der durch die Methode initialisiert wird und damit einen zweiten Rückgabewert darstellt.)

Hinweise

Viele Drucker benötigen bis zu einem Viertel eines Zolls unbedruckten Platz an den Rändern jeder Seite, um das Papier zu greifen und durch den Drucker zu bewegen. Andernfalls würde Der Toner den Papierflussmechanismus verletzen. Der Bereich, der gedruckt werden kann, ist der "bildbare Bereich".

Der Typ PrintDocumentImageableArea verfügt über keinen öffentlichen Konstruktor. Daher muss die Variable documentImageableArea deklariert und zugewiesen null werden und erst dann an die -Methode übergeben werden. Diese Methode zeigt eine PrintDialog vom Benutzer erforderliche Eingabe an. Nachdem der Benutzer einen Drucker, ein Papierformat und eine Ausrichtung ausgewählt und den Dialog geschlossen hat, documentImageableArea zeigt auf ein tatsächliches Objekt, und dessen Eigenschaften werden initialisiert.

Wenn der Benutzer das Dialogfeld abbricht oder schließt, ist nullder Rückgabewert . Daher muss der Rückgabewert von Ihrer Anwendung überprüft null werden.

Weitere Informationen

• isXPS-Konformitätstool

CreateXpsDocumentWriter(String, PrintDocumentImageableArea, PageRangeSelection, PageRange)

Erstellt ein XpsDocumentWriter-Objekt, öffnet einen Windows-Standarddruckdialog, an den ein Seitenbereich übergeben wird, und gibt einen ref-Parameter (ByRef in Visual Basic) zurück, der Informationen zum Druckbereich und den Abmessungen des Mediums darstellt.

public:
 static System::Windows::Xps::XpsDocumentWriter ^ CreateXpsDocumentWriter(System::String ^ jobDescription, System::Printing::PrintDocumentImageableArea ^ % documentImageableArea, System::Windows::Controls::PageRangeSelection % pageRangeSelection, System::Windows::Controls::PageRange % pageRange);

public static System.Windows.Xps.XpsDocumentWriter CreateXpsDocumentWriter (string jobDescription, ref System.Printing.PrintDocumentImageableArea documentImageableArea, ref System.Windows.Controls.PageRangeSelection pageRangeSelection, ref System.Windows.Controls.PageRange pageRange);

static member CreateXpsDocumentWriter : string * PrintDocumentImageableArea * PageRangeSelection * PageRange -> System.Windows.Xps.XpsDocumentWriter

Public Shared Function CreateXpsDocumentWriter (jobDescription As String, ByRef documentImageableArea As PrintDocumentImageableArea, ByRef pageRangeSelection As PageRangeSelection, ByRef pageRange As PageRange) As XpsDocumentWriter

Parameter

jobDescription

String

Ein Name für den Druckauftrag. Der Name wird in der Druckbenutzeroberfläche von Windows angezeigt.

documentImageableArea

PrintDocumentImageableArea

Ein Verweis auf ein Objekt, das die Abmessungen des Seitenbereichs angibt, in dem das Gerät drucken kann. Da der Datentyp über keinen öffentlichen Konstruktor verfügt, wird dieser Parameter nicht initialisiert übergeben.

pageRangeSelection

PageRangeSelection

Ein Wert, der angibt, ob alle Seiten gedruckt werden oder nur ein vom Benutzer ausgewählter Seitenbereich.

pageRange

PageRange

Der zu druckende Seitenbereich.

Gibt zurück

XpsDocumentWriter

Ein XpsDocumentWriter, der XPS-Daten in einen Stream schreibt. Dieser Wert kann null sein. (Die Parameter documentImageableArea, pageRangeSelection und pageRange sind alle ref-Parameter [ByRef in Visual Basic], die vom Benutzer initialisiert und beim Schließen des Dialogfelds zurückgegeben werden. Damit stellt jeder Parameter einen zusätzlichen Rückgabewert dar.)

Hinweise

Viele Drucker benötigen bis zu einem Viertel eines Zolls unbedruckten Platz an den Rändern jeder Seite, um das Papier zu greifen und durch den Drucker zu bewegen. Andernfalls würde Der Toner den Papierflussmechanismus verletzen. Der Bereich, der gedruckt werden kann, ist der "bildbare Bereich".

Der Typ PrintDocumentImageableArea verfügt über keinen öffentlichen Konstruktor. Daher muss die Variable documentImageableArea deklariert und zugewiesen null werden und erst dann an die -Methode übergeben werden. Diese Methode zeigt eine PrintDialog vom Benutzer erforderliche Eingabe an. Der Benutzer konfiguriert seinen Druckauftrag im Dialogfeld (einschließlich Auswahl eines Druckers, Papierformats, Ausrichtung und Seitenbereichs). Wenn das Dialogfeld geschlossen ist und pageRangeSelectionpageRange Werte aufweist und documentImageableArea auf ein tatsächliches Objekt verweist, dessen Eigenschaften initialisiert werden.

Wenn der Benutzer das Dialogfeld abbricht oder schließt, ist nullder Rückgabewert . Daher muss der Rückgabewert von Ihrer Anwendung überprüft null werden.

Weitere Informationen

• isXPS-Konformitätstool