PrintQueue.CreateXpsDocumentWriter Methode

Definitie

Hiermee maakt u een XpsDocumentWriter-object.

Overloads

Name Description
CreateXpsDocumentWriter(PrintDocumentImageableArea, PageRangeSelection, PageRange)

Hiermee maakt u een XpsDocumentWriter-object, opent u een Windows gemeenschappelijk afdrukdialoogvenster, geeft u het dialoogvenster een paginabereik en een beschrijving van de afdruktaak en retourneert u een parameter ref (ByRef in Visual Basic) die informatie vertegenwoordigt over het afdrukbare gebied en de afmetingen van de media.

CreateXpsDocumentWriter(PrintDocumentImageableArea)

Hiermee maakt u een XpsDocumentWriter-object, opent u een Windows algemene afdrukdialoogvenster en retourneert u een parameter ref (ByRef in Visual Basic) die informatie over het afbeeldingsbare gebied en de afmetingen van de media vertegenwoordigt.

CreateXpsDocumentWriter(PrintQueue)

Hiermee maakt u een XpsDocumentWriter object en koppelt u het aan de opgegeven afdrukwachtrij.

CreateXpsDocumentWriter(Double, Double)

Hiermee maakt u een XpsDocumentWriter object met de opgegeven dimensies.

CreateXpsDocumentWriter(String, PrintDocumentImageableArea)

Hiermee maakt u een XpsDocumentWriter-object, opent u een Windows algemene afdrukdialoogvenster (en geeft dit een taakbeschrijving) en retourneert u een parameter ref (ByRef in Visual Basic) die informatie over het afbeeldingsbare gebied en de afmetingen van de media vertegenwoordigt.

CreateXpsDocumentWriter(String, PrintDocumentImageableArea, PageRangeSelection, PageRange)

Hiermee maakt u een XpsDocumentWriter-object, opent u een Windows algemene afdrukdialoogvenster, wordt het dialoogvenster voorzien van een paginabereik en wordt een ref (ByRef in Visual Basic) weergegeven die informatie vertegenwoordigt over het afbeeldingsbare gebied en de afmetingen van de media.

CreateXpsDocumentWriter(PrintDocumentImageableArea, PageRangeSelection, PageRange)

Hiermee maakt u een XpsDocumentWriter-object, opent u een Windows gemeenschappelijk afdrukdialoogvenster, geeft u het dialoogvenster een paginabereik en een beschrijving van de afdruktaak en retourneert u een parameter ref (ByRef in Visual Basic) die informatie vertegenwoordigt over het afdrukbare gebied en de afmetingen van de media.

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

Parameters

documentImageableArea
PrintDocumentImageableArea

Een verwijzing naar een object met de afmetingen van het gebied van de pagina waarop het apparaat kan afdrukken. Omdat het gegevenstype geen openbare constructor heeft, wordt deze parameter niet-geïnitialiseerd doorgegeven.

pageRangeSelection
PageRangeSelection

Een waarde die aangeeft of alle pagina's moeten worden afgedrukt of alleen een bereik dat is opgegeven door de gebruiker.

pageRange
PageRange

Het bereik van pagina's dat wordt afgedrukt.

Retouren

Een XpsDocumentWriter die XPS-gegevens naar een stream schrijft. Dit kan zijn null. (De parameters documentImageableArea, pageRangeSelection en pageRange zijn allemaal ref [ByRef in Visual Basic] parameters die door de gebruiker worden geïnitialiseerd en geretourneerd wanneer het dialoogvenster wordt gesloten, zodat elk een extra geretourneerd item vertegenwoordigt.)

Kenmerken

Opmerkingen

Veel printers hebben tot een kwart van een inch ongeprinte ruimte rond de randen van elke pagina nodig om het papier vast te houden en door de printer te verplaatsen. Anders zou toner het papierstroommechanisme beschadigen. Het gebied dat kan worden afgedrukt, is het 'bebeeldbare gebied'.

Het type PrintDocumentImageableArea heeft geen openbare constructor. Daarom moet de variabele documentImageableArea worden gedeclareerd en toegewezen null aan en alleen vervolgens aan de methode worden doorgegeven. Met deze methode wordt een PrintDialog vereiste invoer van de gebruiker weergegeven. De gebruiker configureert de afdruktaak in het dialoogvenster (waaronder het selecteren van een printer, papierformaat, afdrukstand en paginabereik). Wanneer het dialoogvenster is gesloten pageRangeSelection en pageRange waarden heeft en documentImageableArea verwijst naar een werkelijk object waarvan de eigenschappen worden geïnitialiseerd.

Als de gebruiker het dialoogvenster annuleert of sluit, is nullde retourwaarde. Als gevolg hiervan moet de retourwaarde worden gecontroleerd null door uw toepassing.

Zie ook

Van toepassing op

CreateXpsDocumentWriter(PrintDocumentImageableArea)

Hiermee maakt u een XpsDocumentWriter-object, opent u een Windows algemene afdrukdialoogvenster en retourneert u een parameter ref (ByRef in Visual Basic) die informatie over het afbeeldingsbare gebied en de afmetingen van de media vertegenwoordigt.

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);
[<System.Security.SecurityCritical>]
static member CreateXpsDocumentWriter : PrintDocumentImageableArea -> System.Windows.Xps.XpsDocumentWriter
Public Shared Function CreateXpsDocumentWriter (ByRef documentImageableArea As PrintDocumentImageableArea) As XpsDocumentWriter

Parameters

documentImageableArea
PrintDocumentImageableArea

Een verwijzing naar een object met de afmetingen van het gebied van de pagina waarop het apparaat kan afdrukken. Omdat het gegevenstype geen openbare constructor heeft, wordt deze parameter niet-geïnitialiseerd doorgegeven.

Retouren

Een XpsDocumentWriter die XPS-gegevens naar een stream schrijft. Dit kan zijn null. (De parameter documentImageableArea is een ref [ByRef in Visual Basic] parameter die door de methode wordt geïnitialiseerd, dus het vertegenwoordigt een tweede geretourneerd item.)

Kenmerken

Opmerkingen

Veel printers hebben tot een kwart van een inch ongeprinte ruimte rond de randen van elke pagina nodig om het papier vast te houden en door de printer te verplaatsen. Anders zou toner het papierstroommechanisme beschadigen. Het gebied dat kan worden afgedrukt, is het 'bebeeldbare gebied'.

Het type PrintDocumentImageableArea heeft geen openbare constructor. Daarom moet de variabele documentImageableArea worden gedeclareerd en toegewezen null aan en alleen vervolgens aan de methode worden doorgegeven. Met deze methode wordt een PrintDialog vereiste invoer van de gebruiker weergegeven. Nadat de gebruiker een printer, papierformaat en afdrukstand heeft geselecteerd en het dialoogvenster heeft gesloten, documentImageableArea verwijst u naar een werkelijk object en de eigenschappen ervan worden geïnitialiseerd.

Als de gebruiker het dialoogvenster annuleert of sluit, is nullde retourwaarde. Als gevolg hiervan moet de retourwaarde worden gecontroleerd null door uw toepassing.

Zie ook

Van toepassing op

CreateXpsDocumentWriter(PrintQueue)

Hiermee maakt u een XpsDocumentWriter object en koppelt u het aan de opgegeven afdrukwachtrij.

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

Parameters

printQueue
PrintQueue

Een afdrukwachtrij om het XPS-document af te drukken.

Retouren

Een XpsDocumentWriter stroom die naar een XPS-stream schrijft.

Voorbeelden

In het volgende voorbeeld ziet u hoe u deze methode gebruikt om een 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()

Zie ook

Van toepassing op

CreateXpsDocumentWriter(Double, Double)

Hiermee maakt u een XpsDocumentWriter object met de opgegeven dimensies.

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);
[<System.Security.SecurityCritical>]
static member CreateXpsDocumentWriter : double * double -> System.Windows.Xps.XpsDocumentWriter
Public Shared Function CreateXpsDocumentWriter (ByRef width As Double, ByRef height As Double) As XpsDocumentWriter

Parameters

width
Double

De breedte van het XPS-document.

height
Double

De hoogte van het XPS-document.

Retouren

Een XpsDocumentWriter stroom die naar een XPS-stream schrijft. Dit kan zijn null.

Kenmerken

Opmerkingen

Met deze methode wordt een PrintDialog vereiste invoer van de gebruiker weergegeven. Als de gebruiker het dialoogvenster annuleert of sluit, is nullde retourwaarde. Als gevolg hiervan moet de retourwaarde worden gecontroleerd null door uw toepassing.

Zie ook

Van toepassing op

CreateXpsDocumentWriter(String, PrintDocumentImageableArea)

Hiermee maakt u een XpsDocumentWriter-object, opent u een Windows algemene afdrukdialoogvenster (en geeft dit een taakbeschrijving) en retourneert u een parameter ref (ByRef in Visual Basic) die informatie over het afbeeldingsbare gebied en de afmetingen van de media vertegenwoordigt.

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);
[<System.Security.SecurityCritical>]
static member CreateXpsDocumentWriter : string * PrintDocumentImageableArea -> System.Windows.Xps.XpsDocumentWriter
Public Shared Function CreateXpsDocumentWriter (jobDescription As String, ByRef documentImageableArea As PrintDocumentImageableArea) As XpsDocumentWriter

Parameters

jobDescription
String

Een naam voor de afdruktaak. Deze wordt weergegeven in de Windows gebruikersinterface voor afdrukken.

documentImageableArea
PrintDocumentImageableArea

Een verwijzing naar een object met de afmetingen van het gebied van de pagina waarop het apparaat kan afdrukken. Omdat het gegevenstype geen openbare constructor heeft, wordt deze parameter niet-geïnitialiseerd doorgegeven.

Retouren

Een XpsDocumentWriter die XPS-gegevens naar een stream schrijft. Dit kan zijn null. (De parameter documentImageableArea is een ref [ByRef in Visual Basic] parameter die door de methode wordt geïnitialiseerd, dus het vertegenwoordigt een tweede geretourneerd item.)

Kenmerken

Opmerkingen

Veel printers hebben tot een kwart van een inch ongeprinte ruimte rond de randen van elke pagina nodig om het papier vast te houden en door de printer te verplaatsen. Anders zou toner het papierstroommechanisme beschadigen. Het gebied dat kan worden afgedrukt, is het 'bebeeldbare gebied'.

Het type PrintDocumentImageableArea heeft geen openbare constructor. Daarom moet de variabele documentImageableArea worden gedeclareerd en toegewezen null aan en alleen vervolgens aan de methode worden doorgegeven. Met deze methode wordt een PrintDialog vereiste invoer van de gebruiker weergegeven. Nadat de gebruiker een printer, papierformaat en afdrukstand heeft geselecteerd en het dialoogvenster heeft gesloten, documentImageableArea verwijst u naar een werkelijk object en worden de eigenschappen ervan geïnitialiseerd.

Als de gebruiker het dialoogvenster annuleert of sluit, is nullde retourwaarde. Als gevolg hiervan moet de retourwaarde worden gecontroleerd null door uw toepassing.

Zie ook

Van toepassing op

CreateXpsDocumentWriter(String, PrintDocumentImageableArea, PageRangeSelection, PageRange)

Hiermee maakt u een XpsDocumentWriter-object, opent u een Windows algemene afdrukdialoogvenster, wordt het dialoogvenster voorzien van een paginabereik en wordt een ref (ByRef in Visual Basic) weergegeven die informatie vertegenwoordigt over het afbeeldingsbare gebied en de afmetingen van de media.

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

Parameters

jobDescription
String

Een naam voor de afdruktaak. Deze wordt weergegeven in de Windows gebruikersinterface voor afdrukken.

documentImageableArea
PrintDocumentImageableArea

Een verwijzing naar een object met de afmetingen van het gebied van de pagina waarop het apparaat kan afdrukken. Omdat het gegevenstype geen openbare constructor heeft, wordt deze parameter niet-geïnitialiseerd doorgegeven.

pageRangeSelection
PageRangeSelection

Een waarde die aangeeft of alle pagina's moeten worden afgedrukt of alleen een bereik dat is opgegeven door de gebruiker.

pageRange
PageRange

Het bereik van pagina's dat wordt afgedrukt.

Retouren

Een XpsDocumentWriter die XPS-gegevens naar een stream schrijft. Dit kan zijn null. (De parameters documentImageableArea, pageRangeSelection en pageRange zijn allemaal ref [ByRef in Visual Basic] parameters die door de gebruiker worden geïnitialiseerd en geretourneerd wanneer het dialoogvenster wordt gesloten, zodat elk een extra geretourneerd item vertegenwoordigt.)

Kenmerken

Opmerkingen

Veel printers hebben tot een kwart van een inch ongeprinte ruimte rond de randen van elke pagina nodig om het papier vast te houden en door de printer te verplaatsen. Anders zou toner het papierstroommechanisme beschadigen. Het gebied dat kan worden afgedrukt, is het 'bebeeldbare gebied'.

Het type PrintDocumentImageableArea heeft geen openbare constructor. Daarom moet de variabele documentImageableArea worden gedeclareerd en toegewezen null aan en alleen vervolgens aan de methode worden doorgegeven. Met deze methode wordt een PrintDialog vereiste invoer van de gebruiker weergegeven. De gebruiker configureert de afdruktaak in het dialoogvenster (waaronder het selecteren van een printer, papierformaat, afdrukstand en paginabereik). Wanneer het dialoogvenster is gesloten pageRangeSelection en pageRange waarden heeft en documentImageableArea verwijst naar een werkelijk object waarvan de eigenschappen worden geïnitialiseerd.

Als de gebruiker het dialoogvenster annuleert of sluit, is nullde retourwaarde. Als gevolg hiervan moet de retourwaarde worden gecontroleerd null door uw toepassing.

Zie ook

Van toepassing op