PrintQueue.CreateXpsDocumentWriter Méthode

Définition

Espace de noms:

System.Printing

Assembly:

System.Printing.dll

Elle crée un objet XpsDocumentWriter.

Surcharges

CreateXpsDocumentWriter(PrintDocumentImageableArea, PageRangeSelection, PageRange)	Crée un objet XpsDocumentWriter, ouvre une boîte de dialogue d'impression commune de Windows, lui fournit l'étendue de pages et la description du travail d'impression, et retourne un paramètre ref (ByRef dans Visual Basic) qui représente des informations sur la zone imageable et les dimensions du média.
CreateXpsDocumentWriter(PrintDocumentImageableArea)	Crée un objet XpsDocumentWriter, ouvre une boîte de dialogue d'impression commune de Windows et retourne un paramètre ref (ByRef dans Visual Basic) qui représente des informations sur la zone imageable et les dimensions du média.
CreateXpsDocumentWriter(PrintQueue)	Crée un objet XpsDocumentWriter et l'associe à la file d'attente à l'impression spécifiée.
CreateXpsDocumentWriter(Double, Double)	Crée un objet XpsDocumentWriter avec les dimensions spécifiées.
CreateXpsDocumentWriter(String, PrintDocumentImageableArea)	Crée un objet XpsDocumentWriter, ouvre une boîte de dialogue d'impression commune de Windows (et lui fournit une description du travail) et retourne un paramètre ref (ByRef dans Visual Basic) qui représente des informations sur la zone imageable et les dimensions du média.
CreateXpsDocumentWriter(String, PrintDocumentImageableArea, PageRangeSelection, PageRange)	Crée un objet XpsDocumentWriter, ouvre une boîte de dialogue d'impression commune de Windows, lui fournit une étendue de pages, et retourne un paramètre ref (ByRef dans Visual Basic) qui représente des informations sur la zone imageable et les dimensions du média.

CreateXpsDocumentWriter(PrintDocumentImageableArea, PageRangeSelection, PageRange)

Crée un objet XpsDocumentWriter, ouvre une boîte de dialogue d'impression commune de Windows, lui fournit l'étendue de pages et la description du travail d'impression, et retourne un paramètre ref (ByRef dans Visual Basic) qui représente des informations sur la zone imageable et les dimensions du média.

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

Paramètres

documentImageableArea

PrintDocumentImageableArea

Référence à un objet qui contient les dimensions de la surface de la page sur laquelle le périphérique peut procéder à l'impression. Étant donné que son type de données ne dispose d'aucun constructeur public, ce paramètre est passé sans être initialisé.

pageRangeSelection

PageRangeSelection

Valeur qui spécifie s'il faut imprimer toutes les pages ou uniquement une étendue de pages spécifiée par l'utilisateur.

pageRange

PageRange

Étendue des pages en cours d'impression.

Retours

XpsDocumentWriter

XpsDocumentWriter qui écrit les données XPS dans un flux. Il peut s’agir de null. (Les paramètres documentImageableArea, pageRangeSelection et pageRange sont tous des paramètres ref [ByRef dans Visual Basic] initialisés par l'utilisateur et retournés à la fermeture de la boîte de dialogue, ainsi chaque paramètre représente un élément retourné supplémentaire.)

Remarques

De nombreuses imprimantes ont besoin d’un quart de pouce d’espace non imprimé autour des bords de chaque page pour saisir le papier et le déplacer dans l’imprimante. Sinon, le toner encrasserait le mécanisme de flux papier. La zone qui peut être imprimée est la « zone imageable ».

Le type PrintDocumentImageableArea n’a pas de constructeur public. Par conséquent, la variable documentImageableArea doit être déclarée et affectée à null , puis seulement passée à la méthode . Cette méthode affiche une PrintDialog entrée requise de l’utilisateur. L’utilisateur configure son travail d’impression dans la boîte de dialogue (y compris la sélection d’une imprimante, du format de papier, de l’orientation et de la plage de pages). Lorsque la boîte de dialogue est fermée, pageRangeSelection elle a des pageRange valeurs et documentImageableArea pointe vers un objet réel dont les propriétés sont initialisées.

Si l’utilisateur annule ou ferme la boîte de dialogue, la valeur de retour est null. Par conséquent, la valeur de retour doit être vérifiée null par votre application.

Voir aussi

• IsXPS Conformance Tool

CreateXpsDocumentWriter(PrintDocumentImageableArea)

Crée un objet XpsDocumentWriter, ouvre une boîte de dialogue d'impression commune de Windows et retourne un paramètre ref (ByRef dans Visual Basic) qui représente des informations sur la zone imageable et les dimensions du média.

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

Paramètres

documentImageableArea

PrintDocumentImageableArea

Référence à un objet qui contient les dimensions de la surface de la page sur laquelle le périphérique peut procéder à l'impression. Étant donné que son type de données ne dispose d'aucun constructeur public, ce paramètre est passé sans être initialisé.

Retours

XpsDocumentWriter

XpsDocumentWriter qui écrit les données XPS dans un flux. Il peut s’agir de null. (Le paramètre documentImageableArea est un paramètre ref [ByRef dans Visual Basic] qui est initialisé par la méthode ; il représente par conséquent un second élément retourné.)

Remarques

De nombreuses imprimantes ont besoin d’un quart de pouce d’espace non imprimé autour des bords de chaque page pour saisir le papier et le déplacer dans l’imprimante. Sinon, le toner encrasserait le mécanisme de flux papier. La zone qui peut être imprimée est la « zone imageable ».

Le type PrintDocumentImageableArea n’a pas de constructeur public. Par conséquent, la variable documentImageableArea doit être déclarée et affectée à null , puis seulement passée à la méthode . Cette méthode affiche une PrintDialog entrée requise de l’utilisateur. Une fois que l’utilisateur a sélectionné une imprimante, un format de papier et une orientation et fermé la boîte de dialogue, documentImageableArea pointe vers un objet réel et ses propriétés sont initialisées.

Si l’utilisateur annule ou ferme la boîte de dialogue, la valeur de retour est null. Par conséquent, la valeur de retour doit être vérifiée null par votre application.

Voir aussi

• IsXPS Conformance Tool

CreateXpsDocumentWriter(PrintQueue)

Crée un objet XpsDocumentWriter et l'associe à la file d'attente à l'impression spécifiée.

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

Paramètres

printQueue

PrintQueue

File d'attente à l'impression devant imprimer le document XPS.

Retours

XpsDocumentWriter

XpsDocumentWriter qui écrit dans un flux de données XPS.

Exemples

L’exemple suivant montre comment utiliser cette méthode pour créer un 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()

Voir aussi

• IsXPS Conformance Tool

CreateXpsDocumentWriter(Double, Double)

Crée un objet XpsDocumentWriter avec les dimensions spécifiées.

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

Paramètres

width

Double

Largeur du document XPS.

height

Double

Hauteur du document XPS.

Retours

XpsDocumentWriter

XpsDocumentWriter qui écrit dans un flux de données XPS. Il peut s’agir de null.

Remarques

Cette méthode affiche une PrintDialog entrée requise de l’utilisateur. Si l’utilisateur annule ou ferme la boîte de dialogue, la valeur de retour est null. Par conséquent, la valeur de retour doit être vérifiée null par votre application.

Voir aussi

• IsXPS Conformance Tool

CreateXpsDocumentWriter(String, PrintDocumentImageableArea)

Crée un objet XpsDocumentWriter, ouvre une boîte de dialogue d'impression commune de Windows (et lui fournit une description du travail) et retourne un paramètre ref (ByRef dans Visual Basic) qui représente des informations sur la zone imageable et les dimensions du média.

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

Paramètres

jobDescription

String

Nom du travail d'impression. Apparaît dans l'interface utilisateur d'impression Windows.

documentImageableArea

PrintDocumentImageableArea

Référence à un objet qui contient les dimensions de la surface de la page sur laquelle le périphérique peut procéder à l'impression. Étant donné que son type de données ne dispose d'aucun constructeur public, ce paramètre est passé sans être initialisé.

Retours

XpsDocumentWriter

XpsDocumentWriter qui écrit les données XPS dans un flux. Il peut s’agir de null. (Le paramètre documentImageableArea est un paramètre ref [ByRef dans Visual Basic] qui est initialisé par la méthode ; il représente par conséquent un second élément retourné.)

Remarques

De nombreuses imprimantes ont besoin d’un quart de pouce d’espace non imprimé autour des bords de chaque page pour saisir le papier et le déplacer dans l’imprimante. Sinon, le toner encrasserait le mécanisme de flux papier. La zone qui peut être imprimée est la « zone imageable ».

Le type PrintDocumentImageableArea n’a pas de constructeur public. Par conséquent, la variable documentImageableArea doit être déclarée et affectée à null , puis seulement passée à la méthode . Cette méthode affiche une PrintDialog entrée requise de l’utilisateur. Une fois que l’utilisateur a sélectionné une imprimante, un format de papier et une orientation et fermé la boîte de dialogue, documentImageableArea pointe vers un objet réel et ses propriétés sont initialisées.

Si l’utilisateur annule ou ferme la boîte de dialogue, la valeur de retour est null. Par conséquent, la valeur de retour doit être vérifiée null par votre application.

Voir aussi

• IsXPS Conformance Tool

CreateXpsDocumentWriter(String, PrintDocumentImageableArea, PageRangeSelection, PageRange)

Crée un objet XpsDocumentWriter, ouvre une boîte de dialogue d'impression commune de Windows, lui fournit une étendue de pages, et retourne un paramètre ref (ByRef dans Visual Basic) qui représente des informations sur la zone imageable et les dimensions du média.

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

Paramètres

jobDescription

String

Nom du travail d'impression. Apparaît dans l'interface utilisateur d'impression Windows.

documentImageableArea

PrintDocumentImageableArea

Référence à un objet qui contient les dimensions de la surface de la page sur laquelle le périphérique peut procéder à l'impression. Étant donné que son type de données ne dispose d'aucun constructeur public, ce paramètre est passé sans être initialisé.

pageRangeSelection

PageRangeSelection

Valeur qui spécifie s'il faut imprimer toutes les pages ou uniquement une étendue de pages spécifiée par l'utilisateur.

pageRange

PageRange

Étendue des pages en cours d'impression.

Retours

XpsDocumentWriter

XpsDocumentWriter qui écrit les données XPS dans un flux. Il peut s’agir de null. (Les paramètres documentImageableArea, pageRangeSelection et pageRange sont tous des paramètres ref [ByRef dans Visual Basic] initialisés par l'utilisateur et retournés à la fermeture de la boîte de dialogue, ainsi chaque paramètre représente un élément retourné supplémentaire.)

Remarques

De nombreuses imprimantes ont besoin d’un quart de pouce d’espace non imprimé autour des bords de chaque page pour saisir le papier et le déplacer dans l’imprimante. Sinon, le toner encrasserait le mécanisme de flux papier. La zone qui peut être imprimée est la « zone imageable ».

Le type PrintDocumentImageableArea n’a pas de constructeur public. Par conséquent, la variable documentImageableArea doit être déclarée et affectée à null , puis seulement passée à la méthode . Cette méthode affiche une PrintDialog entrée requise de l’utilisateur. L’utilisateur configure son travail d’impression dans la boîte de dialogue (y compris la sélection d’une imprimante, du format de papier, de l’orientation et de la plage de pages). Lorsque la boîte de dialogue est fermée, pageRangeSelection elle a des pageRange valeurs et documentImageableArea pointe vers un objet réel dont les propriétés sont initialisées.

Si l’utilisateur annule ou ferme la boîte de dialogue, la valeur de retour est null. Par conséquent, la valeur de retour doit être vérifiée null par votre application.

Voir aussi

• Outil de conformité isXPS