PrintCapabilities.PageMediaSizeCapability Propriété

Définition

Espace de noms:

System.Printing

Assembly:

ReachFramework.dll

Obtient une collection d'objets PageMediaSize qui identifient les tailles papier et média qu'une imprimante prend en charge.

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)

Valeur de propriété

ReadOnlyCollection<PageMediaSize>

ReadOnlyCollection<T> d'objets PageMediaSize.

Exemples

L’exemple de code suivant montre comment rechercher une valeur particulière dans .PageMediaSizeCapability

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

Remarques

La plupart des propriétés de PrintCapabilities qui ont « Capability » à la fin du nom, telles que CollationCapability, sont des collections de valeurs d’un type énuméré. Mais PageMediaSizeCapability et PageResolutionCapability sont des collections d’objets. Pour les deux dernières propriétés, vous ne pouvez pas tester la présence d’une valeur particulière à l’aide de la méthode Contains de ReadOnlyCollection<T>. En effet, avec les types référence, la méthode retourne true uniquement lorsque l’adresse mémoire de l’objet qui lui est transmise est identique à l’adresse d’un objet dans la collection ; autrement dit, il s’agit du même objet. Étant donné que ce ne sera généralement pas le cas, la méthode retourne false presque toujours même s’il existe un objet dans la collection avec exactement les mêmes valeurs dans toutes ses propriétés que l’objet passé à la méthode Contains de ReadOnlyCollection<T>. Pour déterminer le contenu du PageMediaSizeCapability, vous devez énumérer chacun de ses membres en les comparant à la valeur souhaitée.

Si l’imprimante ne prend pas en charge la sélection de la taille du média, la collection est vide.

Cette propriété correspond au mot clé du PageMediaSizeschéma d’impression.