PrintQueue.CreateXpsDocumentWriter Méthode

Définition

Espace de noms:: System.Printing

Assembly:: System.Printing.dll

Important

Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.

Crée un objet XpsDocumentWriter.

Surcharges

Nom	Description
CreateXpsDocumentWriter(PrintDocumentImageableArea, PageRangeSelection, PageRange)	Crée un XpsDocumentWriter objet, ouvre une boîte de dialogue d’impression commune Windows, fournit la boîte de dialogue avec une plage de pages et une description du travail d’impression et retourne un `ref` paramètre (`ByRef` en Visual Basic) qui représente des informations sur la zone imageable et les dimensions du média.
CreateXpsDocumentWriter(PrintDocumentImageableArea)	Crée un XpsDocumentWriter objet, ouvre une boîte de dialogue d’impression commune Windows et retourne un `ref` paramètre (`ByRef` en Visual Basic) qui représente des informations sur la zone imageable et les dimensions du média.
CreateXpsDocumentWriter(PrintQueue)	Crée un XpsDocumentWriter objet et l’associe à la file d’attente d’impression spécifiée.
CreateXpsDocumentWriter(Double, Double)	Crée un XpsDocumentWriter objet avec les dimensions spécifiées.
CreateXpsDocumentWriter(String, PrintDocumentImageableArea)	Crée un XpsDocumentWriter objet, ouvre une boîte de dialogue d’impression commune Windows (et fournit une description de travail) et retourne un `ref` paramètre (`ByRef` en 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 XpsDocumentWriter objet, ouvre une boîte de dialogue d’impression commune Windows, fournit la boîte de dialogue avec une plage de pages et retourne un `ref` paramètre (`ByRef` en Visual Basic) qui représente des informations sur la zone imageable et les dimensions du média.

CreateXpsDocumentWriter(PrintDocumentImageableArea, PageRangeSelection, PageRange)

Crée un XpsDocumentWriter objet, ouvre une boîte de dialogue d’impression commune Windows, fournit la boîte de dialogue avec une plage de pages et une description du travail d’impression et retourne un ref paramètre (ByRef en 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 zone de la page sur laquelle l’appareil peut imprimer. Étant donné que son type de données n’a pas de constructeur public, ce paramètre est passé non initialisé.

pageRangeSelection: PageRangeSelection

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

pageRange: PageRange

Plage de pages imprimées.

Retours

XpsDocumentWriter

Qui XpsDocumentWriter écrit des données XPS dans un flux. Il peut s’agir de null. (Les paramètres documentImageableArea, pageRangeSelectionet pageRange sont tous ref [ByRef en Visual Basic] paramètres qui sont initialisés par l’utilisateur et retournés lorsque la boîte de dialogue est fermée, de sorte que chacun représente un élément retourné supplémentaire.)

Attributs: SecurityCriticalAttribute

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 à travers l’imprimante. Dans le cas contraire, le toner mettrait en faute le mécanisme de flux de 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 et uniquement passée à la méthode. Cette méthode affiche une PrintDialog entrée obligatoire de l’utilisateur. L’utilisateur configure son travail d’impression dans la boîte de dialogue (y compris la sélection d’une imprimante, de la taille du papier, de l’orientation et de la plage de pages). Lorsque la boîte de dialogue est fermée et pageRangeSelectionpageRange qu’elle a des 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.

S’applique à

CreateXpsDocumentWriter(PrintDocumentImageableArea)

Crée un XpsDocumentWriter objet, ouvre une boîte de dialogue d’impression commune Windows et retourne un ref paramètre (ByRef en 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

Retours

XpsDocumentWriter

Qui XpsDocumentWriter écrit des données XPS dans un flux. Il peut s’agir de null. (Le paramètre est un ref paramètre documentImageableArea [ByRef en Visual Basic] initialisé par la méthode. Il représente donc un deuxième élément retourné.)

Attributs: SecurityCriticalAttribute

Remarques

Le type PrintDocumentImageableArea n’a pas de constructeur public. Par conséquent, la variable documentImageableArea doit être déclarée et affectée à null et uniquement passée à la méthode. Cette méthode affiche une PrintDialog entrée obligatoire de l’utilisateur. Une fois que l’utilisateur a sélectionné une imprimante, une taille 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.

S’applique à

CreateXpsDocumentWriter(PrintQueue)

Crée un XpsDocumentWriter objet et l’associe à la file d’attente d’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 d’impression pour imprimer le document XPS.

Retours

XpsDocumentWriter

Qui XpsDocumentWriter écrit dans un flux 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()

S’applique à

CreateXpsDocumentWriter(Double, Double)

Crée un XpsDocumentWriter objet 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 XpsDocumentWriter écrit dans un flux XPS. Il peut s’agir de null.

Attributs: SecurityCriticalAttribute

Remarques

Cette méthode affiche une PrintDialog entrée obligatoire 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.

S’applique à

CreateXpsDocumentWriter(String, PrintDocumentImageableArea)

Crée un XpsDocumentWriter objet, ouvre une boîte de dialogue d’impression commune Windows (et fournit une description de travail) et retourne un ref paramètre (ByRef en 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. Il apparaît dans l’interface utilisateur d’impression Windows.

documentImageableArea: PrintDocumentImageableArea

Retours

XpsDocumentWriter

Attributs: SecurityCriticalAttribute

Remarques

Le type PrintDocumentImageableArea n’a pas de constructeur public. Par conséquent, la variable documentImageableArea doit être déclarée et affectée à null et uniquement passée à la méthode. Cette méthode affiche une PrintDialog entrée obligatoire de l’utilisateur. Une fois que l’utilisateur a sélectionné une imprimante, une taille 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.

S’applique à

CreateXpsDocumentWriter(String, PrintDocumentImageableArea, PageRangeSelection, PageRange)

Crée un XpsDocumentWriter objet, ouvre une boîte de dialogue d’impression commune Windows, fournit la boîte de dialogue avec une plage de pages et retourne un ref paramètre (ByRef en 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. Il apparaît dans l’interface utilisateur d’impression Windows.

documentImageableArea: PrintDocumentImageableArea

pageRangeSelection: PageRangeSelection

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

pageRange: PageRange

Plage de pages imprimées.

Retours

XpsDocumentWriter

Attributs: SecurityCriticalAttribute

Remarques

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.

S’applique à

Commentaires

Cette page a-t-elle été utile ?