PrintQueue.CreateXpsDocumentWriter Methode

Definition

Namespace:: System.Printing

Assembly:: System.Printing.dll

Wichtig

Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.

Erstellt ein XpsDocumentWriter -Objekt.

Überlädt

Name	Beschreibung
CreateXpsDocumentWriter(PrintDocumentImageableArea, PageRangeSelection, PageRange)	Erstellt ein XpsDocumentWriter Objekt, öffnet ein allgemeines Windows-Druckdialogfeld, stellt das Dialogfeld mit einem Seitenbereich und einer Beschreibung des Druckauftrags bereit und gibt einen `ref` (`ByRef` in Visual Basic)-Parameter zurück, der Informationen zum bildbaren Bereich und den Abmessungen des Mediums darstellt.
CreateXpsDocumentWriter(PrintDocumentImageableArea)	Erstellt ein XpsDocumentWriter Objekt, öffnet ein allgemeines Windows-Druckdialogfeld und gibt einen `ref` (`ByRef` in Visual Basic)-Parameter zurück, der Informationen zum bildbaren Bereich und den Abmessungen des Mediums darstellt.
CreateXpsDocumentWriter(PrintQueue)	Erstellt ein XpsDocumentWriter Objekt und ordnet es der angegebenen Druckwarteschlange zu.
CreateXpsDocumentWriter(Double, Double)	Erstellt ein XpsDocumentWriter Objekt mit den angegebenen Dimensionen.
CreateXpsDocumentWriter(String, PrintDocumentImageableArea)	Erstellt ein XpsDocumentWriter Objekt, öffnet ein allgemeines Windows-Druckdialogfeld (und stellt es eine Auftragsbeschreibung bereit) und gibt einen `ref` (`ByRef` in Visual Basic)-Parameter zurück, der Informationen über den bildbaren Bereich und die Abmessungen des Mediums darstellt.
CreateXpsDocumentWriter(String, PrintDocumentImageableArea, PageRangeSelection, PageRange)	Erstellt ein XpsDocumentWriter Objekt, öffnet ein allgemeines Windows-Druckdialogfeld, stellt das Dialogfeld mit einem Seitenbereich bereit und gibt einen `ref` (`ByRef` in Visual Basic)-Parameter zurück, der Informationen über den bildbaren Bereich und die Abmessungen des Mediums darstellt.

CreateXpsDocumentWriter(PrintDocumentImageableArea, PageRangeSelection, PageRange)

Erstellt ein XpsDocumentWriter Objekt, öffnet ein allgemeines Windows-Druckdialogfeld, stellt das Dialogfeld mit einem Seitenbereich und einer Beschreibung des Druckauftrags bereit und gibt einen ref (ByRef in Visual Basic)-Parameter zurück, der Informationen zum bildbaren Bereich 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);

[System.Security.SecurityCritical]
public static System.Windows.Xps.XpsDocumentWriter CreateXpsDocumentWriter(ref System.Printing.PrintDocumentImageableArea documentImageableArea, ref System.Windows.Controls.PageRangeSelection pageRangeSelection, ref 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);

[<System.Security.SecurityCritical>]
static member CreateXpsDocumentWriter : PrintDocumentImageableArea * PageRangeSelection * PageRange -> System.Windows.Xps.XpsDocumentWriter

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 enthält, auf dem das Gerät drucken kann. Da der Datentyp keinen öffentlichen Konstruktor aufweist, wird dieser Parameter nicht initialisiert.

pageRangeSelection: PageRangeSelection

Ein Wert, der angibt, ob alle Seiten oder nur ein Bereich gedruckt werden soll, der vom Benutzer angegeben wird.

pageRange: PageRange

Der Seitenbereich, der gedruckt wird.

Gibt zurück

XpsDocumentWriter

Ein XpsDocumentWriter Objekt, das XPS-Daten in einen Datenstrom schreibt. Dieser Wert kann null sein. (Die Parameter documentImageableArea, pageRangeSelectionund pageRange sind alle ref [ByRef in Visual Basic] Parameter, die vom Benutzer initialisiert und zurückgegeben werden, wenn das Dialogfeld geschlossen wird, sodass jedes ein zusätzliches zurückgegebenes Element darstellt.)

Attribute: SecurityCriticalAttribute

Hinweise

Viele Drucker benötigen bis zu ein Viertel zoll ungedruckten Platz um die Ränder jeder Seite, um das Papier zu greifen und ihn durch den Drucker zu bewegen. Andernfalls würde Toner den Papierflussmechanismus verleumden. Der bereich, der gedruckt werden kann, ist der "bildbare Bereich".

Der Typ PrintDocumentImageableArea hat keinen öffentlichen Konstruktor. Daher muss die Variable documentImageableArea deklariert und zugewiesen null und nur dann an die Methode übergeben werden. Diese Methode zeigt eine PrintDialog erforderliche Eingabe des Benutzers an. Der Benutzer konfiguriert seinen Druckauftrag im Dialogfeld (einschließlich Auswahl eines Druckers, Papierformats, Ausrichtung und Seitenbereich). Wenn das Dialogfeld geschlossen pageRangeSelection ist und pageRange Werte enthält und documentImageableArea auf ein tatsächliches Objekt verweist, dessen Eigenschaften initialisiert werden.

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

Gilt für:

CreateXpsDocumentWriter(PrintDocumentImageableArea)

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

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

[System.Security.SecurityCritical]
public static System.Windows.Xps.XpsDocumentWriter CreateXpsDocumentWriter(ref System.Printing.PrintDocumentImageableArea documentImageableArea);

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

[<System.Security.SecurityCritical>]
static member CreateXpsDocumentWriter : PrintDocumentImageableArea -> System.Windows.Xps.XpsDocumentWriter

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

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

Parameter

documentImageableArea: PrintDocumentImageableArea

Gibt zurück

XpsDocumentWriter

Ein XpsDocumentWriter Objekt, das XPS-Daten in einen Datenstrom schreibt. Dieser Wert kann null sein. (Der Parameter documentImageableArea ist ein ref [ByRef in Visual Basic]-Parameter, der von der Methode initialisiert wird, sodass er ein zweites zurückgegebenes Element darstellt.)

Attribute: SecurityCriticalAttribute

Hinweise

Der Typ PrintDocumentImageableArea hat keinen öffentlichen Konstruktor. Daher muss die Variable documentImageableArea deklariert und zugewiesen null und nur dann an die Methode übergeben werden. Diese Methode zeigt eine PrintDialog erforderliche Eingabe des Benutzers an. Nachdem der Benutzer einen Drucker, ein Papierformat und eine Ausrichtung ausgewählt und das Dialogfeld geschlossen hat, documentImageableArea wird auf ein tatsächliches Objekt und seine Eigenschaften initialisiert.

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

Gilt für:

CreateXpsDocumentWriter(PrintQueue)

Erstellt ein XpsDocumentWriter Objekt und ordnet 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 zum Drucken des XPS-Dokuments.

Gibt zurück

XpsDocumentWriter

Ein XpsDocumentWriter Objekt, das in einen XPS-Datenstrom schreibt.

Beispiele

Das folgende Beispiel zeigt, wie Sie diese Methode zum Erstellen einer XpsDocumentWriter.

// -------------------- 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()

Gilt für:

CreateXpsDocumentWriter(Double, Double)

Erstellt ein XpsDocumentWriter Objekt mit den angegebenen Dimensionen.

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

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

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

[<System.Security.SecurityCritical>]
static member CreateXpsDocumentWriter : double * double -> System.Windows.Xps.XpsDocumentWriter

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 Objekt, das in einen XPS-Datenstrom schreibt. Dieser Wert kann null sein.

Attribute: SecurityCriticalAttribute

Hinweise

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

Gilt für:

CreateXpsDocumentWriter(String, PrintDocumentImageableArea)

Erstellt ein XpsDocumentWriter Objekt, öffnet ein allgemeines Windows-Druckdialogfeld (und stellt es eine Auftragsbeschreibung bereit) und gibt einen ref (ByRef in Visual Basic)-Parameter zurück, der Informationen über den bildbaren Bereich und die Abmessungen des Mediums darstellt.

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

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

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

[<System.Security.SecurityCritical>]
static member CreateXpsDocumentWriter : string * PrintDocumentImageableArea -> System.Windows.Xps.XpsDocumentWriter

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. Sie wird auf der Windows-Druck-Benutzeroberfläche angezeigt.

documentImageableArea: PrintDocumentImageableArea

Gibt zurück

XpsDocumentWriter

Attribute: SecurityCriticalAttribute

Hinweise

Der Typ PrintDocumentImageableArea hat keinen öffentlichen Konstruktor. Daher muss die Variable documentImageableArea deklariert und zugewiesen null und nur dann an die Methode übergeben werden. Diese Methode zeigt eine PrintDialog erforderliche Eingabe des Benutzers an. Nachdem der Benutzer einen Drucker, ein Papierformat und eine Ausrichtung ausgewählt und das Dialogfeld geschlossen hat, documentImageableArea verweist auf ein tatsächliches Objekt, und seine Eigenschaften werden initialisiert.

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

Gilt für:

CreateXpsDocumentWriter(String, PrintDocumentImageableArea, PageRangeSelection, PageRange)

Erstellt ein XpsDocumentWriter Objekt, öffnet ein allgemeines Windows-Druckdialogfeld, stellt das Dialogfeld mit einem Seitenbereich bereit und gibt einen ref (ByRef in Visual Basic)-Parameter zurück, der Informationen über den bildbaren Bereich und die 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);

[System.Security.SecurityCritical]
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);

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

[<System.Security.SecurityCritical>]
static member CreateXpsDocumentWriter : string * PrintDocumentImageableArea * PageRangeSelection * PageRange -> System.Windows.Xps.XpsDocumentWriter

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. Sie wird auf der Windows-Druck-Benutzeroberfläche angezeigt.

documentImageableArea: PrintDocumentImageableArea

pageRangeSelection: PageRangeSelection

Ein Wert, der angibt, ob alle Seiten oder nur ein Bereich gedruckt werden soll, der vom Benutzer angegeben wird.

pageRange: PageRange

Der Seitenbereich, der gedruckt wird.

Gibt zurück

XpsDocumentWriter

Attribute: SecurityCriticalAttribute

Hinweise

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

Gilt für:

Feedback

War diese Seite hilfreich?

Freigeben über

PrintQueue.CreateXpsDocumentWriter Methode

Definition

Überlädt

CreateXpsDocumentWriter(PrintDocumentImageableArea, PageRangeSelection, PageRange)

Parameter

Gibt zurück

Hinweise

Gilt für:

CreateXpsDocumentWriter(PrintDocumentImageableArea)

Parameter

Gibt zurück

Hinweise

Gilt für:

CreateXpsDocumentWriter(PrintQueue)

Parameter

Gibt zurück

Beispiele

Gilt für:

CreateXpsDocumentWriter(Double, Double)

Parameter

Gibt zurück

Hinweise

Gilt für:

CreateXpsDocumentWriter(String, PrintDocumentImageableArea)

Parameter

Gibt zurück

Hinweise

Gilt für:

CreateXpsDocumentWriter(String, PrintDocumentImageableArea, PageRangeSelection, PageRange)

Parameter

Gibt zurück

Hinweise

Gilt für:

Feedback