PrintQueue.CreateXpsDocumentWriter Methode

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

Gibt zurück

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

Attribute

SecurityCriticalAttribute

Hinweise

Viele Drucker benötigen bis zu einem Viertel Zoll unbedruckten Platz an den Rändern jeder Seite, um das Papier zu greifen und durch den Drucker zu bewegen. Andernfalls würde toner den Papierflussmechanismus verleeren. 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

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

Gibt zurück

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

Attribute

SecurityCriticalAttribute

Hinweise

Viele Drucker benötigen bis zu einem Viertel Zoll unbedruckten Platz an den Rändern jeder Seite, um das Papier zu greifen und durch den Drucker zu bewegen. Andernfalls würde toner den Papierflussmechanismus verleeren. 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 das Dialogfeld geschlossen hat, zeigt er 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

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

Gibt zurück

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

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

Gibt zurück

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

Attribute

SecurityCriticalAttribute

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

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

Gibt zurück

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

Attribute

SecurityCriticalAttribute

Hinweise

Viele Drucker benötigen bis zu einem Viertel Zoll unbedruckten Platz an den Rändern jeder Seite, um das Papier zu greifen und durch den Drucker zu bewegen. Andernfalls würde toner den Papierflussmechanismus verleeren. 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 das Dialogfeld geschlossen hat, documentImageableArea zeigt er 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

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

Gibt zurück

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

Attribute

SecurityCriticalAttribute

Hinweise

Viele Drucker benötigen bis zu einem Viertel Zoll unbedruckten Platz an den Rändern jeder Seite, um das Papier zu greifen und durch den Drucker zu bewegen. Andernfalls würde toner den Papierflussmechanismus verleeren. 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