PrintCapabilities.PageMediaSizeCapability 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 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
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.
