PrintCapabilities.PageMediaSizeCapability Propriedade

Definição

Namespace:

System.Printing

Assembly:

ReachFramework.dll

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

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

public System.Collections.ObjectModel.ReadOnlyCollection<System.Printing.PageMediaSize> PageMediaSizeCapability { get; }

member this.PageMediaSizeCapability : System.Collections.ObjectModel.ReadOnlyCollection<System.Printing.PageMediaSize>

Public ReadOnly Property PageMediaSizeCapability As ReadOnlyCollection(Of PageMediaSize)

Valor da propriedade

ReadOnlyCollection<PageMediaSize>

Uma ReadOnlyCollection<T> de objetos PageMediaSize.

Exemplos

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

foreach (PageMediaSize mediaSize in pc.PageMediaSizeCapability)
    {
        if (mediaSize.PageMediaSizeName == PageMediaSizeName.ISOA4)
        {
            Console.WriteLine("A4 size 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, você não pode 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 PageMediaSizeCapability, você deve enumerar por meio de cada um de seus membros, comparando-os com o valor desejado.

Se a impressora não der suporte à seleção de tamanho de mídia, a coleção estará vazia.

Essa propriedade corresponde ao palavra-chave do Esquema de PageMediaSizeImpressão.