Partager via


PrintQueue.CreateXpsDocumentWriter Méthode

Définition

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

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

Attributs

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

S’applique à

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

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

Attributs

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

S’applique à

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

S’applique à

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

Paramètres

width
Double

Largeur du document XPS.

height
Double

Hauteur du document XPS.

Retours

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

Attributs

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

S’applique à

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

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

Attributs

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

S’applique à

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

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

Attributs

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

S’applique à