PrintCapabilities.PageMediaSizeCapability Propriedade

Definição

Espaço de Nomes:
System.Printing
Assemblagem:
ReachFramework.dll

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

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 de Propriedade

ReadOnlyCollection<PageMediaSize>

A ReadOnlyCollection<T> de PageMediaSize objetos.

Exemplos

O exemplo de código seguinte mostra como procurar um valor particular no PageMediaSizeCapability.

foreach (PageMediaSize mediaSize in pc.PageMediaSizeCapability)
    {
        if (mediaSize.PageMediaSizeName == PageMediaSizeName.ISOA4)
        {
            Console.WriteLine("A4 size is supported");
            break;
        }
    }

Observações

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 estas duas últimas propriedades, não se pode testar a presença de um valor particular usando o método Contains de ReadOnlyCollection<T>. Isto deve-se ao facto de, nos tipos de referência, o método só retorna true quando o endereço de memória do objeto que lhe é passado é igual ao endereço de um objeto na coleção; ou seja, são o mesmo objeto. Como isto normalmente não será o caso, o método quase sempre retornará false mesmo que exista 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, deve enumerar através de cada um dos seus membros, comparando-os com o valor desejado.

Se a impressora não suportar a seleção do tamanho do suporte, a coleção fica vazia.

Esta propriedade corresponde à palavra-chave do PageMediaSize.

Aplica-se a