Exportar (0) Imprimir
Expandir Tudo
Este artigo foi traduzido por máquina. Coloque o ponteiro do mouse sobre as frases do artigo para ver o texto original. Mais informações.
Tradução
Original

Classe PrintCapabilities

Define os recursos de uma impressora.

System.Object
  System.Printing.PrintCapabilities

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

public sealed class PrintCapabilities

O tipo PrintCapabilities expõe os membros a seguir.

  NomeDescrição
Método públicoPrintCapabilitiesInicializa uma nova instância da classe de PrintCapabilities usando um fluxo XML (que contém um documento de PrintCapabilities) que especifica recursos da impressora e siga com XML Esquema de cópia.
Superior

  NomeDescrição
Propriedade públicaCollationCapabilityObtém uma coleção de valores que identificam os recursos de agrupamento de uma impressora.
Propriedade públicaDeviceFontSubstitutionCapabilityObtém uma coleção de valores que identificam se e como uma impressora pode substituir fontes dispositivo baseadas em fontes por computador.
Propriedade públicaDuplexingCapabilityObtém uma coleção de valores que identificam se e como uma impressora pode executar a impressão frente e verso.
Propriedade públicaInputBinCapabilityObtém uma coleção de valores que indicam que bin de entrada (placa do papel) é usado.
Propriedade públicaMaxCopyCountObtém um valor que indica o número máximo de cópias que o dispositivo pode imprimir em um único trabalho de cópia.
Propriedade públicaOrientedPageMediaHeightObtém um valor que indica a altura da área imageable em uma página, onde a altura significa a dimensão vertical em relação à orientação da página.
Propriedade públicaOrientedPageMediaWidthObtém um valor que indica a largura da área imageable em uma página, onde significa a dimensão a largura horizontal em relação à orientação da página.
Propriedade públicaOutputColorCapabilityObtém uma coleção de valores que especificam os modos nos quais uma impressora pode imprimir o conteúdo com a cor e as máscaras de cinza.
Propriedade públicaOutputQualityCapabilityObtém uma coleção de valores que indicam que os tipos de qualidade de saída a impressora oferecer suporte.
Propriedade públicaPageBorderlessCapabilityObtém uma coleção de valores que indicam se a impressora pode imprimir até a borda da mídia.
Propriedade públicaPageImageableAreaObtém um objeto que representa a área de uma página que a impressora possa usar.
Propriedade públicaPageMediaSizeCapabilityObtém uma coleção de objetos PageMediaSize que identificam o papel e os tamanhos de mídia que uma impressora oferecer suporte.
Propriedade públicaPageMediaTypeCapabilityObtém uma coleção de valores que identificam tipos de papel e de outros meios uma impressora oferecer suporte.
Propriedade públicaPageOrderCapabilityObtém uma coleção de valores que indicam se uma impressora é capaz de documentos de várias página de impressão de dianteiro-à- novamente, parte-à- avançar, ou de duas formas.
Propriedade públicaPageOrientationCapabilityObtém uma coleção de valores que identificam tipos de orientação da página uma impressora oferecer suporte.
Propriedade públicaPageResolutionCapabilityObtém uma coleção de objetos PageResolution que identificam quais níveis de resolução de página a impressora oferecer suporte.
Propriedade públicaPageScalingFactorRangeObtém os percentuais máximo e mínimo pelo qual uma impressora pode ampliar ou reduzir a imagem de cópia em uma página.
Propriedade públicaPagesPerSheetCapabilityObtém uma coleção de valores inteiros, cada um que identifica o número de páginas que um usuário pode escolher para imprimir em um único lado de uma folha de papel.
Propriedade públicaPagesPerSheetDirectionCapabilityObtém uma coleção de valores padrão que identificam uma impressora oferecer suporte com várias páginas em um único lado de uma folha de papel.
Propriedade públicaPhotoPrintingIntentCapabilityObtém uma coleção de valores que identificam as opções de qualidade a impressora oferecer suporte para imprimir fotografias.
Propriedade públicaStaplingCapabilityObtém uma coleção de valores que identificam tipos de grampear automática que uma impressora oferecer suporte.
Propriedade públicaTrueTypeFontModeCapabilityObtém uma coleção de valores que identificam os métodos que uma impressora oferecer suporte ao tratar fontes de TrueType.
Superior

  NomeDescrição
Método públicoEquals(Object) Verifica se o objeto especificado é igual ao objeto atual. (Herdado de Object.)
Método públicoGetHashCodeServe como a função de hash padrão. (Herdado de Object.)
Método públicoGetType Obtém o Type da instância atual. (Herdado de Object.)
Método públicoToStringRetorna uma string que representa o objeto atual. (Herdado de Object.)
Superior

Um objeto de PrintCapabilities é fácil-à-trabalho- com a representação de um determinado tipo de documento XML chamado em um documento de PrintCapabilities. O último é um instantâneo de todas as suas configurações atuais de uma impressora e recursos. Por exemplo, se a impressora oferecer suporte a impressão de cores, o documento teria um elemento de <PageOutputColor … > exposto como a saída de cores serão tratadas. O elemento, é representado por sua vez pela propriedade de OutputColorCapability do objeto de PrintCapabilities . Se a impressora não oferece suporte a cor, não há nenhum elemento de <PageOutputColor … > no documento e o valor da propriedade de OutputColorCapability é null. O documento de PrintCapabilities deve estar de acordo com o. Esquema de cópia

A classe de PrintCapabilities permite que o seu aplicativo obter os recursos de uma impressora sem ter que participar de qualquer leitura direta de objetos de Stream XML.

Todos os recursos mais populares de impressoras de arquivo e fotografia, para o início e a empresa, são encapsuladas pela classe de PrintCapabilities . Define mais, mas Esquema de cópia menos comum, recursos e pode ser estendido para controlar recursos de dispositivos de impressão shop. Assim, embora as classes de PrintTicket e de PrintCapabilities não podem ser herdadas, você pode estender Esquema de cópia para reconhecer os recursos do dispositivo da cópia que não são considerados nas classes de PrintTicket ou de PrintCapabilities .

Observação   Quando PrintCapabilities o objeto é criado com o construtor que usa um documento de PrintCapabilities (como Streamo parâmetro), esse documento inteiro é armazenado em um campo de não utilitário no objeto, incluindo elementos XML dentro delas que expressam menos recursos comuns que não são representados por algumas das propriedades públicas do PrintCapabilities classe. De fato, se o driver que gerou o documento de PrintCapabilities estiver usando uma extensão privada Esquema de cópiado, essa marcação confidencialmente definida também são armazenadas como parte do documento de PrintCapabilities que não seja do utilitário.

Observação de cuidadoCuidado

As classes no namespace de System.Printing não têm suporte para uso dentro de um serviço do Windows ou um aplicativo ou serviço do ASP.NET. Tentando usar essas classes de dentro de um desses tipos de aplicativos pode gerar problemas inesperados, tal como diminuição na performance do serviço e exceções em tempo de execução.

Se você deseja imprimir de um aplicativo Windows Forms, consulte o namespace de System.Drawing.Printing .

O exemplo a seguir mostra como determinar os recursos de uma impressora específica e como configurar um trabalho de impressão tirar proveito de.


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

Com suporte em: 4.5.2, 4.5.1, 4.5, 4, 3.5, 3.0

.NET Framework Client Profile

Com suporte em: 4, 3.5 SP1

Windows Phone 8.1, Windows Phone 8, Windows 8.1, Windows Server 2012 R2, Windows 8, Windows Server 2012, Windows 7, Windows Vista SP2, Windows Server 2008 (Função Server Core sem suporte), Windows Server 2008 R2 (Função Server Core com suporte com o SP1 ou posterior, Itanium sem suporte)

O .NET Framework não oferece suporte a todas as versões de cada plataforma. Para obter uma lista das versões com suporte, consulte Requisitos do sistema do .NET Framework.

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

Contribuições da comunidade

ADICIONAR
Mostrar:
© 2014 Microsoft