PrintCapabilities.PageResolutionCapability Propriedade
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.
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
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.
