PrintQueue.CreateXpsDocumentWriter Methode
Definitie
Belangrijk
Bepaalde informatie heeft betrekking op een voorlopige productversie die aanzienlijk kan worden gewijzigd voordat deze wordt uitgebracht. Microsoft biedt geen enkele expliciete of impliciete garanties met betrekking tot de informatie die hier wordt verstrekt.
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 |
| CreateXpsDocumentWriter(PrintDocumentImageableArea) |
Hiermee maakt u een XpsDocumentWriter-object, opent u een Windows algemene afdrukdialoogvenster en retourneert u een parameter |
| 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 |
| 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 |
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.