PrintCapabilities.PageResolutionCapability Propriedade

Definição

Namespace:

System.Printing

Assembly:

ReachFramework.dll

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

public:
 property System::Collections::ObjectModel::ReadOnlyCollection<System::Printing::PageResolution ^> ^ PageResolutionCapability { System::Collections::ObjectModel::ReadOnlyCollection<System::Printing::PageResolution ^> ^ get(); };

public System.Collections.ObjectModel.ReadOnlyCollection<System.Printing.PageResolution> PageResolutionCapability { get; }

member this.PageResolutionCapability : System.Collections.ObjectModel.ReadOnlyCollection<System.Printing.PageResolution>

Public ReadOnly Property PageResolutionCapability As ReadOnlyCollection(Of PageResolution)

Valor da propriedade

ReadOnlyCollection<PageResolution>

Uma ReadOnlyCollection<T> de objetos PageResolution. Cada valor representa uma resolução de página como um valor qualitativo, um valor de pontos por polegada ou ambos.

Exemplos

O exemplo de código a seguir mostra como pesquisar um valor específico no PageResolutionCapability.

foreach (PageResolution pageRes in pc.PageResolutionCapability)
    {
        if (pageRes.QualitativeResolution == PageQualitativeResolution.High)
        {
            Console.WriteLine("High quality is supported");
            break;
        }
    }

Comentários

A maioria das propriedades de PrintCapabilities que têm "Capability" no final do nome, como CollationCapability, são coleções de valores de um tipo enumerado. Mas PageMediaSizeCapability e PageResolutionCapability são coleções de objetos. Para as duas últimas propriedades, não é possível testar a presença de um valor específico usando o método Contains de ReadOnlyCollection<T>. Isso ocorre porque, com tipos de referência, o método retorna true somente quando o endereço de memória do objeto passado para ele é o mesmo que o endereço de um objeto na coleção; ou seja, eles são o mesmo objeto. Como isso geralmente não será o caso, o método quase sempre retornará false mesmo se houver um objeto na coleção com exatamente os mesmos valores em todas as suas propriedades que o objeto passado para o método Contains de ReadOnlyCollection<T>. Para determinar o conteúdo do PageResolutionCapability, você deve enumerar por meio de cada um de seus membros, comparando-os com o valor desejado. Consulte o exemplo.

A PageResolution classe tem propriedades nas quais você pode especificar os pontos por polegada para as dimensões X e Y e uma propriedade em que você pode dar uma expressão qualitativa à resolução.

Se a impressora não der suporte a opções de resolução de página, a coleção estará vazia.

Essa propriedade corresponde à palavra-chave do Esquema de PageResolutionImpressão.