PrintQueue.CreateXpsDocumentWriter Metodo

Definizione

Spazio dei nomi:

System.Printing

Assembly:

System.Printing.dll

Crea un oggetto XpsDocumentWriter.

Overload

Nome	Descrizione
CreateXpsDocumentWriter(PrintDocumentImageableArea, PageRangeSelection, PageRange)	Crea un XpsDocumentWriter oggetto, apre una finestra di dialogo di stampa comune di Windows, fornisce la finestra di dialogo con un intervallo di pagine e una descrizione del processo di stampa e restituisce un ref parametro (ByRef in Visual Basic) che rappresenta le informazioni sull'area stampabile e sulle dimensioni del supporto.
CreateXpsDocumentWriter(PrintDocumentImageableArea)	Crea un XpsDocumentWriter oggetto, apre una finestra di dialogo di stampa comune di Windows e restituisce un ref parametro (ByRef in Visual Basic) che rappresenta le informazioni sull'area stampabile e sulle dimensioni del supporto.
CreateXpsDocumentWriter(PrintQueue)	Crea un XpsDocumentWriter oggetto e lo associa alla coda di stampa specificata.
CreateXpsDocumentWriter(Double, Double)	Crea un XpsDocumentWriter oggetto con le dimensioni specificate.
CreateXpsDocumentWriter(String, PrintDocumentImageableArea)	Crea un XpsDocumentWriter oggetto, apre una finestra di dialogo di stampa comune di Windows e la fornisce una descrizione del processo e restituisce un ref parametro (ByRef in Visual Basic) che rappresenta le informazioni sull'area stampabile e sulle dimensioni del supporto.
CreateXpsDocumentWriter(String, PrintDocumentImageableArea, PageRangeSelection, PageRange)	Crea un XpsDocumentWriter oggetto, apre una finestra di dialogo di stampa comune di Windows, fornisce la finestra di dialogo con un intervallo di pagine e restituisce un ref parametro (ByRef in Visual Basic) che rappresenta le informazioni sull'area stampabile e sulle dimensioni del supporto.

CreateXpsDocumentWriter(PrintDocumentImageableArea, PageRangeSelection, PageRange)

Crea un XpsDocumentWriter oggetto, apre una finestra di dialogo di stampa comune di Windows, fornisce la finestra di dialogo con un intervallo di pagine e una descrizione del processo di stampa e restituisce un ref parametro (ByRef in Visual Basic) che rappresenta le informazioni sull'area stampabile e sulle dimensioni del supporto.

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

Parametri

documentImageableArea

PrintDocumentImageableArea

Riferimento a un oggetto che contiene le dimensioni dell'area della pagina in cui il dispositivo può stampare. Poiché il tipo di dati non ha un costruttore pubblico, questo parametro viene passato non inizializzato.

pageRangeSelection

PageRangeSelection

Valore che specifica se stampare tutte le pagine o solo un intervallo specificato dall'utente.

pageRange

PageRange

Intervallo di pagine stampate.

Valori restituiti

XpsDocumentWriter

Oggetto XpsDocumentWriter che scrive i dati XPS in un flusso. Può essere null. I parametri documentImageableArea, pageRangeSelectione pageRange sono tutti [ByRefref in Visual Basic] parametri inizializzati dall'utente e restituiti quando la finestra di dialogo viene chiusa, quindi ognuno rappresenta un elemento restituito aggiuntivo.

Commenti

Molte stampanti devono avere fino a un quarto di pollice di spazio non stampato intorno ai bordi di ogni pagina per afferrare la carta e spostarla attraverso la stampante. In caso contrario, il toner avrebbe fatto male al meccanismo di flusso della carta. L'area che può essere stampata è l'area "immaginebile".

Il tipo PrintDocumentImageableArea non ha un costruttore pubblico. Di conseguenza, la variabile documentImageableArea deve essere dichiarata e assegnata a null e solo successivamente passata al metodo . Questo metodo visualizza un PrintDialog input che richiede l'input dell'utente. L'utente configura il proprio processo di stampa nella finestra di dialogo (inclusa la selezione di una stampante, una dimensione della carta, l'orientamento e l'intervallo di pagine). Quando la finestra di dialogo viene chiusa pageRangeSelection e pageRange ha valori e documentImageableArea punta a un oggetto effettivo le cui proprietà vengono inizializzate.

Se l'utente annulla o chiude la finestra di dialogo, il valore restituito è null. Di conseguenza, il valore restituito deve essere controllato null dall'applicazione.

CreateXpsDocumentWriter(PrintDocumentImageableArea)

Crea un XpsDocumentWriter oggetto, apre una finestra di dialogo di stampa comune di Windows e restituisce un ref parametro (ByRef in Visual Basic) che rappresenta le informazioni sull'area stampabile e sulle dimensioni del supporto.

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

Parametri

documentImageableArea

PrintDocumentImageableArea

Riferimento a un oggetto che contiene le dimensioni dell'area della pagina in cui il dispositivo può stampare. Poiché il tipo di dati non ha un costruttore pubblico, questo parametro viene passato non inizializzato.

Valori restituiti

XpsDocumentWriter

Oggetto XpsDocumentWriter che scrive i dati XPS in un flusso. Può essere null. Il parametro è un ref parametro documentImageableArea [ByRef in Visual Basic] inizializzato dal metodo , quindi rappresenta un secondo elemento restituito.

Commenti

Molte stampanti devono avere fino a un quarto di pollice di spazio non stampato intorno ai bordi di ogni pagina per afferrare la carta e spostarla attraverso la stampante. In caso contrario, il toner avrebbe fatto male al meccanismo di flusso della carta. L'area che può essere stampata è l'area "immaginebile".

Il tipo PrintDocumentImageableArea non ha un costruttore pubblico. Di conseguenza, la variabile documentImageableArea deve essere dichiarata e assegnata a null e solo successivamente passata al metodo . Questo metodo visualizza un PrintDialog input che richiede l'input dell'utente. Dopo che l'utente ha selezionato una stampante, le dimensioni della carta e l'orientamento e ha chiuso la finestra di dialogo, documentImageableArea punta a un oggetto effettivo e le relative proprietà vengono inizializzate.

Se l'utente annulla o chiude la finestra di dialogo, il valore restituito è null. Di conseguenza, il valore restituito deve essere controllato null dall'applicazione.

CreateXpsDocumentWriter(PrintQueue)

Crea un XpsDocumentWriter oggetto e lo associa alla coda di stampa specificata.

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

Parametri

printQueue

PrintQueue

Coda di stampa per stampare il documento XPS.

Valori restituiti

XpsDocumentWriter

Oggetto XpsDocumentWriter che scrive in un flusso XPS.

Esempio

Nell'esempio seguente viene illustrato come usare questo metodo per creare un oggetto 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()

CreateXpsDocumentWriter(Double, Double)

Crea un XpsDocumentWriter oggetto con le dimensioni specificate.

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

Parametri

width

Double

Larghezza del documento XPS.

height

Double

Altezza del documento XPS.

Valori restituiti

XpsDocumentWriter

Oggetto XpsDocumentWriter che scrive in un flusso XPS. Può essere null.

Commenti

Questo metodo visualizza un PrintDialog input che richiede l'input dell'utente. Se l'utente annulla o chiude la finestra di dialogo, il valore restituito è null. Di conseguenza, il valore restituito deve essere controllato null dall'applicazione.

CreateXpsDocumentWriter(String, PrintDocumentImageableArea)

Crea un XpsDocumentWriter oggetto, apre una finestra di dialogo di stampa comune di Windows e la fornisce una descrizione del processo e restituisce un ref parametro (ByRef in Visual Basic) che rappresenta le informazioni sull'area stampabile e sulle dimensioni del supporto.

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

Parametri

jobDescription

String

Nome del processo di stampa. Viene visualizzato nell'interfaccia utente di stampa di Windows.

documentImageableArea

PrintDocumentImageableArea

Riferimento a un oggetto che contiene le dimensioni dell'area della pagina in cui il dispositivo può stampare. Poiché il tipo di dati non ha un costruttore pubblico, questo parametro viene passato non inizializzato.

Valori restituiti

XpsDocumentWriter

Oggetto XpsDocumentWriter che scrive i dati XPS in un flusso. Può essere null. Il parametro è un ref parametro documentImageableArea [ByRef in Visual Basic] inizializzato dal metodo , quindi rappresenta un secondo elemento restituito.

Commenti

Molte stampanti devono avere fino a un quarto di pollice di spazio non stampato intorno ai bordi di ogni pagina per afferrare la carta e spostarla attraverso la stampante. In caso contrario, il toner avrebbe fatto male al meccanismo di flusso della carta. L'area che può essere stampata è l'area "immaginebile".

Il tipo PrintDocumentImageableArea non ha un costruttore pubblico. Di conseguenza, la variabile documentImageableArea deve essere dichiarata e assegnata a null e solo successivamente passata al metodo . Questo metodo visualizza un PrintDialog input che richiede l'input dell'utente. Dopo che l'utente ha selezionato una stampante, le dimensioni della carta e l'orientamento e ha chiuso il dialogo, documentImageableArea punta a un oggetto effettivo e le relative proprietà vengono inizializzate.

Se l'utente annulla o chiude la finestra di dialogo, il valore restituito è null. Di conseguenza, il valore restituito deve essere controllato null dall'applicazione.

CreateXpsDocumentWriter(String, PrintDocumentImageableArea, PageRangeSelection, PageRange)

Crea un XpsDocumentWriter oggetto, apre una finestra di dialogo di stampa comune di Windows, fornisce la finestra di dialogo con un intervallo di pagine e restituisce un ref parametro (ByRef in Visual Basic) che rappresenta le informazioni sull'area stampabile e sulle dimensioni del supporto.

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

Parametri

jobDescription

String

Nome del processo di stampa. Viene visualizzato nell'interfaccia utente di stampa di Windows.

documentImageableArea

PrintDocumentImageableArea

Riferimento a un oggetto che contiene le dimensioni dell'area della pagina in cui il dispositivo può stampare. Poiché il tipo di dati non ha un costruttore pubblico, questo parametro viene passato non inizializzato.

pageRangeSelection

PageRangeSelection

Valore che specifica se stampare tutte le pagine o solo un intervallo specificato dall'utente.

pageRange

PageRange

Intervallo di pagine stampate.

Valori restituiti

XpsDocumentWriter

Oggetto XpsDocumentWriter che scrive i dati XPS in un flusso. Può essere null. I parametri documentImageableArea, pageRangeSelectione pageRange sono tutti [ByRefref in Visual Basic] parametri inizializzati dall'utente e restituiti quando la finestra di dialogo viene chiusa, quindi ognuno rappresenta un elemento restituito aggiuntivo.

Commenti

Molte stampanti devono avere fino a un quarto di pollice di spazio non stampato intorno ai bordi di ogni pagina per afferrare la carta e spostarla attraverso la stampante. In caso contrario, il toner avrebbe fatto male al meccanismo di flusso della carta. L'area che può essere stampata è l'area "immaginebile".

Il tipo PrintDocumentImageableArea non ha un costruttore pubblico. Di conseguenza, la variabile documentImageableArea deve essere dichiarata e assegnata a null e solo successivamente passata al metodo . Questo metodo visualizza un PrintDialog input che richiede l'input dell'utente. L'utente configura il proprio processo di stampa nella finestra di dialogo (inclusa la selezione di una stampante, una dimensione della carta, l'orientamento e l'intervallo di pagine). Quando la finestra di dialogo viene chiusa pageRangeSelection e pageRange ha valori e documentImageableArea punta a un oggetto effettivo le cui proprietà vengono inizializzate.

Se l'utente annulla o chiude la finestra di dialogo, il valore restituito è null. Di conseguenza, il valore restituito deve essere controllato null dall'applicazione.