PrintQueue.CreateXpsDocumentWriter Método
Definição
Importante
Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.
Cria um objeto de XpsDocumentWriter .
Sobrecargas
| CreateXpsDocumentWriter(PrintDocumentImageableArea, PageRangeSelection, PageRange) |
Cria um objeto XpsDocumentWriter, abre uma caixa diálogo de impressão comum do Windows, fornece um intervalo de página e uma descrição do trabalho de impressão à caixa de diálogo e retorna um parâmetro |
| CreateXpsDocumentWriter(PrintDocumentImageableArea) |
Cria um objeto XpsDocumentWriter, abre uma caixa de diálogo de impressão comum do Windows e retorna um parâmetro |
| CreateXpsDocumentWriter(PrintQueue) |
Cria um objeto XpsDocumentWriter e o associa com a fila de impressão especificada. |
| CreateXpsDocumentWriter(Double, Double) |
Cria um objeto XpsDocumentWriter com as dimensões especificadas. |
| CreateXpsDocumentWriter(String, PrintDocumentImageableArea) |
Cria um objeto XpsDocumentWriter, abre uma caixa de diálogo de impressão comum do Windows (e fornece a ela uma descrição do trabalho) e retorna um parâmetro |
| CreateXpsDocumentWriter(String, PrintDocumentImageableArea, PageRangeSelection, PageRange) |
Cria um objeto XpsDocumentWriter, abre uma caixa diálogo de impressão comum do Windows, fornece um intervalo de página à caixa de diálogo e retorna um parâmetro |
CreateXpsDocumentWriter(PrintDocumentImageableArea, PageRangeSelection, PageRange)
Cria um objeto XpsDocumentWriter, abre uma caixa diálogo de impressão comum do Windows, fornece um intervalo de página e uma descrição do trabalho de impressão à caixa de diálogo e retorna um parâmetro ref (ByRef no Visual Basic) que representa informações sobre a área de imagem permitida e as dimensões da 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.XpsDocumentWriterstatic member CreateXpsDocumentWriter : PrintDocumentImageableArea * PageRangeSelection * PageRange -> System.Windows.Xps.XpsDocumentWriterPublic Shared Function CreateXpsDocumentWriter (ByRef documentImageableArea As PrintDocumentImageableArea, ByRef pageRangeSelection As PageRangeSelection, ByRef pageRange As PageRange) As XpsDocumentWriterParâmetros
- documentImageableArea
- PrintDocumentImageableArea
Uma referência a um objeto que contém as dimensões da área da página em que o dispositivo pode imprimir. Como seu tipo de dados não tem um construtor público, este parâmetro é passado não inicializado.
- pageRangeSelection
- PageRangeSelection
Um valor que especifica se deve-se imprimir todas as páginas ou apenas um intervalo especificado pelo usuário.
- pageRange
- PageRange
O intervalo de páginas que é impresso.
Retornos
Um XpsDocumentWriter que grava dados XPS em um fluxo. Ele pode ser null. (Os parâmetros documentImageableArea, pageRangeSelection e pageRange são todos parâmetros ref – ByRef no Visual Basic – que são inicializados pelo usuário e retornados quando a caixa de diálogo é fechada, portanto, cada um representa um item retornado adicional).
- Atributos
Comentários
Muitas impressoras precisam de até um quarto de polegada de espaço não impresso ao redor das bordas de cada página para segurar o papel e movê-lo através da impressora. Caso contrário, toner sujaria o mecanismo de fluxo de papel. A área que pode ser impressa é a "área de imagem".
O tipo PrintDocumentImageableArea não tem construtor público. Portanto, a variável documentImageableArea deve ser declarada e atribuída a null e somente depois passada para o método . Esse método exibe uma PrintDialog entrada que exige do usuário. O usuário configura seu trabalho de impressão na caixa de diálogo (incluindo a seleção de uma impressora, tamanho do papel, orientação e intervalo de páginas). Quando a caixa de diálogo é fechada e pageRangeSelectionpageRange tem valores e documentImageableArea aponta para um objeto real cujas propriedades são inicializadas.
Se o usuário cancelar ou fechar a caixa de diálogo, o valor retornado será null. Como consequência, o valor retornado deve ser verificado null pelo seu aplicativo.
Confira também
Aplica-se a
CreateXpsDocumentWriter(PrintDocumentImageableArea)
Cria um objeto XpsDocumentWriter, abre uma caixa de diálogo de impressão comum do Windows e retorna um parâmetro ref (ByRef no Visual Basic) que representa informações sobre a área de imagem permitida e as dimensões da 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.XpsDocumentWriterstatic member CreateXpsDocumentWriter : PrintDocumentImageableArea -> System.Windows.Xps.XpsDocumentWriterPublic Shared Function CreateXpsDocumentWriter (ByRef documentImageableArea As PrintDocumentImageableArea) As XpsDocumentWriterParâmetros
- documentImageableArea
- PrintDocumentImageableArea
Uma referência a um objeto que contém as dimensões da área da página em que o dispositivo pode imprimir. Como seu tipo de dados não tem um construtor público, este parâmetro é passado não inicializado.
Retornos
Um XpsDocumentWriter que grava dados XPS em um fluxo. Ele pode ser null. (O parâmetro documentImageableArea é um parâmetro ref – ByRef no Visual Basic – que é inicializado pelo método, portanto ele representa um segundo item retornado).
- Atributos
Comentários
Muitas impressoras precisam de até um quarto de polegada de espaço não impresso ao redor das bordas de cada página para segurar o papel e movê-lo através da impressora. Caso contrário, toner sujaria o mecanismo de fluxo de papel. A área que pode ser impressa é a "área de imagem".
O tipo PrintDocumentImageableArea não tem construtor público. Portanto, a variável documentImageableArea deve ser declarada e atribuída a null e somente depois passada para o método . Esse método exibe uma PrintDialog entrada que exige do usuário. Depois que o usuário tiver selecionado uma impressora, o tamanho do papel e a orientação e fechado a caixa de diálogo, documentImageableArea apontará para um objeto real e suas propriedades serão inicializadas.
Se o usuário cancelar ou fechar a caixa de diálogo, o valor retornado será null. Como consequência, o valor retornado deve ser verificado null pelo seu aplicativo.
Confira também
Aplica-se a
CreateXpsDocumentWriter(PrintQueue)
Cria um objeto XpsDocumentWriter e o associa com a fila de impressão especificada.
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.XpsDocumentWriterPublic Shared Function CreateXpsDocumentWriter (printQueue As PrintQueue) As XpsDocumentWriterParâmetros
- printQueue
- PrintQueue
Uma fila de impressão para imprimir o documento XPS.
Retornos
Um XpsDocumentWriter que grava em um fluxo de XPS.
Exemplos
O exemplo a seguir mostra como usar esse método para criar um 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()
Confira também
Aplica-se a
CreateXpsDocumentWriter(Double, Double)
Cria um objeto XpsDocumentWriter com as dimensões especificadas.
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.XpsDocumentWriterstatic member CreateXpsDocumentWriter : double * double -> System.Windows.Xps.XpsDocumentWriterPublic Shared Function CreateXpsDocumentWriter (ByRef width As Double, ByRef height As Double) As XpsDocumentWriterParâmetros
- width
- Double
A largura do documento XPS.
- height
- Double
A altura do documento XPS.
Retornos
Um XpsDocumentWriter que grava em um fluxo de XPS. Ele pode ser null.
- Atributos
Comentários
Esse método exibe uma PrintDialog entrada que exige do usuário. Se o usuário cancelar ou fechar a caixa de diálogo, o valor retornado será null. Como consequência, o valor retornado deve ser verificado null pelo seu aplicativo.
Confira também
Aplica-se a
CreateXpsDocumentWriter(String, PrintDocumentImageableArea)
Cria um objeto XpsDocumentWriter, abre uma caixa de diálogo de impressão comum do Windows (e fornece a ela uma descrição do trabalho) e retorna um parâmetro ref (ByRef no Visual Basic) que representa informações sobre a área de imagem permitida e as dimensões da 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.XpsDocumentWriterstatic member CreateXpsDocumentWriter : string * PrintDocumentImageableArea -> System.Windows.Xps.XpsDocumentWriterPublic Shared Function CreateXpsDocumentWriter (jobDescription As String, ByRef documentImageableArea As PrintDocumentImageableArea) As XpsDocumentWriterParâmetros
- jobDescription
- String
Um nome para o trabalho de impressão. Ele aparece na interface do usuário de impressão do Windows.
- documentImageableArea
- PrintDocumentImageableArea
Uma referência a um objeto que contém as dimensões da área da página em que o dispositivo pode imprimir. Como seu tipo de dados não tem um construtor público, este parâmetro é passado não inicializado.
Retornos
Um XpsDocumentWriter que grava dados XPS em um fluxo. Ele pode ser null. (O parâmetro documentImageableArea é um parâmetro ref – ByRef no Visual Basic – que é inicializado pelo método, portanto ele representa um segundo item retornado).
- Atributos
Comentários
Muitas impressoras precisam de até um quarto de polegada de espaço não impresso ao redor das bordas de cada página para segurar o papel e movê-lo através da impressora. Caso contrário, toner sujaria o mecanismo de fluxo de papel. A área que pode ser impressa é a "área de imagem".
O tipo PrintDocumentImageableArea não tem construtor público. Portanto, a variável documentImageableArea deve ser declarada e atribuída a null e somente depois passada para o método . Esse método exibe uma PrintDialog entrada que exige do usuário. Depois que o usuário tiver selecionado uma impressora, o tamanho do papel e a orientação e fechado a caixa de diálogo, documentImageableArea apontará para um objeto real e suas propriedades serão inicializadas.
Se o usuário cancelar ou fechar a caixa de diálogo, o valor retornado será null. Como consequência, o valor retornado deve ser verificado null pelo seu aplicativo.
Confira também
Aplica-se a
CreateXpsDocumentWriter(String, PrintDocumentImageableArea, PageRangeSelection, PageRange)
Cria um objeto XpsDocumentWriter, abre uma caixa diálogo de impressão comum do Windows, fornece um intervalo de página à caixa de diálogo e retorna um parâmetro ref (ByRef no Visual Basic) que representa informações sobre a área de imagem permitida e as dimensões da 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.XpsDocumentWriterstatic member CreateXpsDocumentWriter : string * PrintDocumentImageableArea * PageRangeSelection * PageRange -> System.Windows.Xps.XpsDocumentWriterPublic Shared Function CreateXpsDocumentWriter (jobDescription As String, ByRef documentImageableArea As PrintDocumentImageableArea, ByRef pageRangeSelection As PageRangeSelection, ByRef pageRange As PageRange) As XpsDocumentWriterParâmetros
- jobDescription
- String
Um nome para o trabalho de impressão. Ele aparece na interface do usuário de impressão do Windows.
- documentImageableArea
- PrintDocumentImageableArea
Uma referência a um objeto que contém as dimensões da área da página em que o dispositivo pode imprimir. Como seu tipo de dados não tem um construtor público, este parâmetro é passado não inicializado.
- pageRangeSelection
- PageRangeSelection
Um valor que especifica se deve-se imprimir todas as páginas ou apenas um intervalo especificado pelo usuário.
- pageRange
- PageRange
O intervalo de páginas que é impresso.
Retornos
Um XpsDocumentWriter que grava dados XPS em um fluxo. Ele pode ser null. (Os parâmetros documentImageableArea, pageRangeSelection e pageRange são todos parâmetros ref – ByRef no Visual Basic – que são inicializados pelo usuário e retornados quando a caixa de diálogo é fechada, portanto, cada um representa um item retornado adicional).
- Atributos
Comentários
Muitas impressoras precisam de até um quarto de polegada de espaço não impresso ao redor das bordas de cada página para segurar o papel e movê-lo através da impressora. Caso contrário, toner sujaria o mecanismo de fluxo de papel. A área que pode ser impressa é a "área de imagem".
O tipo PrintDocumentImageableArea não tem construtor público. Portanto, a variável documentImageableArea deve ser declarada e atribuída a null e somente depois passada para o método . Esse método exibe uma PrintDialog entrada que exige do usuário. O usuário configura seu trabalho de impressão na caixa de diálogo (incluindo a seleção de uma impressora, tamanho do papel, orientação e intervalo de páginas). Quando a caixa de diálogo é fechada e pageRangeSelectionpageRange tem valores e documentImageableArea aponta para um objeto real cujas propriedades são inicializadas.
Se o usuário cancelar ou fechar a caixa de diálogo, o valor retornado será null. Como consequência, o valor retornado deve ser verificado null pelo seu aplicativo.
Confira também
Aplica-se a
Comentários
Em breve: Ao longo de 2024, eliminaremos os problemas do GitHub como o mecanismo de comentários para conteúdo e o substituiremos por um novo sistema de comentários. Para obter mais informações, consulte https://aka.ms/ContentUserFeedback.
Enviar e exibir comentários de