Este artigo foi traduzido por máquina. Para visualizar o arquivo em inglês, marque a caixa de seleção Inglês. Você também pode exibir o texto Em inglês em uma janela pop-up, movendo o ponteiro do mouse sobre o texto.
Tradução
Inglês

Classe PrintCapabilities

 

Define as funcionalidades de uma impressora.

Namespace:   System.Printing
Assembly:  ReachFramework (em ReachFramework.dll)

System.Object
  System.Printing.PrintCapabilities

public sealed class PrintCapabilities

NomeDescrição
System_CAPS_pubmethodPrintCapabilities(Stream)

Inicializa uma nova instância de PrintCapabilities classe usando um fluxo XML (que contém um documento PrintCapabilities) que especifica os recursos de impressora e está em conformidade com o XML Print Schema.

NomeDescrição
System_CAPS_pubpropertyCollationCapability

Obtém uma coleção de valores que identificam os recursos de agrupamento de uma impressora.

System_CAPS_pubpropertyDeviceFontSubstitutionCapability

Obtém uma coleção de valores que identificam se e como uma impressora pode substituir fontes com base no dispositivo para fontes baseadas em computador.

System_CAPS_pubpropertyDuplexingCapability

Obtém uma coleção de valores que identificam se e como uma impressora pode executar a impressão de dois lados.

System_CAPS_pubpropertyInputBinCapability

Obtém uma coleção de valores que indicam quais bin de entrada (bandeja) é usado.

System_CAPS_pubpropertyMaxCopyCount

Obtém um valor que indica o número máximo de cópias que o dispositivo pode imprimir em um único trabalho de impressão.

System_CAPS_pubpropertyOrientedPageMediaHeight

Obtém um valor que indica a altura da área de imagem em uma página, em que a altura significa a dimensão vertical em relação a orientação da página.

System_CAPS_pubpropertyOrientedPageMediaWidth

Obtém um valor que indica a largura da área de imagem em uma página, onde largura significa que a dimensão horizontal em relação a orientação da página.

System_CAPS_pubpropertyOutputColorCapability

Obtém uma coleção de valores que especificam as maneiras em que uma impressora pode imprimir conteúdo com cores e tons de cinza.

System_CAPS_pubpropertyOutputQualityCapability

Obtém uma coleção de valores que indicam os tipos de qualidade de saída da impressora oferece suporte.

System_CAPS_pubpropertyPageBorderlessCapability

Obtém uma coleção de valores que indicam se a impressora pode imprimir até a borda da mídia.

System_CAPS_pubpropertyPageImageableArea

Obtém um objeto que representa a área de uma página que pode usar a impressora.

System_CAPS_pubpropertyPageMediaSizeCapability

Obtém uma coleção de PageMediaSize objetos que identificam os tamanhos de papel e mídia que oferece suporte a uma impressora.

System_CAPS_pubpropertyPageMediaTypeCapability

Obtém uma coleção de valores que identificam os tipos de documento e outras mídias que oferece suporte a uma impressora.

System_CAPS_pubpropertyPageOrderCapability

Obtém uma coleção de valores que indicam se uma impressora é capaz de imprimir documentos de várias páginas de frente para trás, para trás para frente ou ambas as direções.

System_CAPS_pubpropertyPageOrientationCapability

Obtém uma coleção de valores que identificam os tipos de orientação de página oferece suporte a uma impressora.

System_CAPS_pubpropertyPageResolutionCapability

Obtém uma coleção de PageResolution objetos que identificam quais níveis de resolução de página a impressora oferece suporte.

System_CAPS_pubpropertyPageScalingFactorRange

Obtém os percentuais mínimos e máximo pelo qual uma impressora pode ampliar ou reduzir a imagem em uma página impressa.

System_CAPS_pubpropertyPagesPerSheetCapability

Obtém uma coleção de inteiros, cada identifica o número de páginas que o usuário pode optar por imprimir em um único lado de uma folha de papel.

System_CAPS_pubpropertyPagesPerSheetDirectionCapability

Obtém uma coleção de valores que identificam quais padrões aceita para apresentar várias páginas em um único lado de uma folha de papel.

System_CAPS_pubpropertyPhotoPrintingIntentCapability

Obtém uma coleção de valores que identificam as opções de qualidade a impressora oferece suporte para imprimir fotografias.

System_CAPS_pubpropertyStaplingCapability

Obtém uma coleção de valores que identificam os tipos de associação automática que oferece suporte a uma impressora.

System_CAPS_pubpropertyTrueTypeFontModeCapability

Obtém uma coleção de valores que identificam os métodos que oferece suporte a uma impressora para lidar com as fontes TrueType.

NomeDescrição
System_CAPS_pubmethodEquals(Object)

Verifica se o objeto especificado é igual ao objeto atual. (Herdado de Object.)

System_CAPS_pubmethodGetHashCode()

Serve como a função de hash padrão.(Herdado de Object.)

System_CAPS_pubmethodGetType()

Obtém o Type da instância atual.(Herdado de Object.)

System_CAPS_pubmethodToString()

Retorna uma string que representa o objeto atual.(Herdado de Object.)

A T:System.Printing.PrintCapabilities object is an easy-to-work-with representation of a certain type of XML document called a PrintCapabilities document. The latter is a snapshot of all of a printer's capabilities and their current settings. For example, if the printer supports color printing, then the document would have a <PageOutputColor … > element that sets out how color output will be handled. The element is, in turn, represented by the P:System.Printing.PrintCapabilities.OutputColorCapability property of the T:System.Printing.PrintCapabilities object. If the printer does not support color, then there is no <PageOutputColor … > element in the document and the value of the P:System.Printing.PrintCapabilities.OutputColorCapability property is null. The PrintCapabilities document must conform to the Print Schemahttp://go.microsoft.com/fwlink/?LinkId=186397.

The T:System.Printing.PrintCapabilities class enables your application to obtain a printer's capabilities without having to engage in any direct reading of XML T:System.IO.Stream objects.

All of the most popular features of file and photo printers, for both home and business, are encapsulated by the T:System.Printing.PrintCapabilities class. But the Print Schemahttp://go.microsoft.com/fwlink/?LinkId=186397 defines many more, less common, features and it can be extended to handle features of specialty printing devices. So, although the T:System.Printing.PrintTicket and T:System.Printing.PrintCapabilities classes cannot be inherited, you can extend the Print Schemahttp://go.microsoft.com/fwlink/?LinkId=186397 to recognize print device features that are not accounted for in the T:System.Printing.PrintTicket or T:System.Printing.PrintCapabilities classes.

Note   When the PrintCapabilities object is created with the constructor that takes a PrintCapabilities document (as a Stream) parameter, that entire document is stored in a non-public field in the object, including the XML elements within it that express less common features that are not represented by any of the public properties of the PrintCapabilities class. In fact, if the driver that produced the PrintCapabilities document is using a private extension of the Print Schema, that privately defined markup is also stored as part of the non-public PrintCapabilities document.

System_CAPS_cautionCuidado

Classes within the N:System.Printing namespace are not supported for use within a Windows service or ASP.NET application or service. Attempting to use these classes from within one of these application types may produce unexpected problems, such as diminished service performance and run-time exceptions.

If you want to print from a Windows Forms application, see the N:System.Drawing.Printing namespace.

The following example shows how to determine the capabilities of a specific printer and how to configure a print job to take advantage of them.

// ---------------------- GetPrintTicketFromPrinter -----------------------
/// <summary>
///   Returns a PrintTicket based on the current default printer.</summary>
/// <returns>
///   A PrintTicket for the current local default printer.</returns>
private PrintTicket GetPrintTicketFromPrinter()
{
    PrintQueue printQueue = null;

    LocalPrintServer localPrintServer = new LocalPrintServer();

    // Retrieving collection of local printer on user machine
    PrintQueueCollection localPrinterCollection =
        localPrintServer.GetPrintQueues();

    System.Collections.IEnumerator localPrinterEnumerator =
        localPrinterCollection.GetEnumerator();

    if (localPrinterEnumerator.MoveNext())
    {
        // Get PrintQueue from first available printer
        printQueue = (PrintQueue)localPrinterEnumerator.Current;
    }
    else
    {
        // No printer exist, return null PrintTicket
        return null;
    }

    // Get default PrintTicket from printer
    PrintTicket printTicket = printQueue.DefaultPrintTicket;

    PrintCapabilities printCapabilites = printQueue.GetPrintCapabilities();

    // Modify PrintTicket
    if (printCapabilites.CollationCapability.Contains(Collation.Collated))
    {
        printTicket.Collation = Collation.Collated;
    }

    if ( printCapabilites.DuplexingCapability.Contains(
            Duplexing.TwoSidedLongEdge) )
    {
        printTicket.Duplexing = Duplexing.TwoSidedLongEdge;
    }

    if (printCapabilites.StaplingCapability.Contains(Stapling.StapleDualLeft))
    {
        printTicket.Stapling = Stapling.StapleDualLeft;
    }

    return printTicket;
}// end:GetPrintTicketFromPrinter()

.NET Framework
Disponível desde 3.0

Quaisquer membros estáticos públicos ( Compartilhado no Visual Basic) desse tipo são thread-safe. Não há garantia de que qualquer membro de instância seja thread-safe.

Retornar ao início
Mostrar: