PrintCapabilities.PageResolutionCapability Propriété

Définition

Espace de noms:

System.Printing

Assembly:

ReachFramework.dll

Obtient une collection d'objets PageResolution qui identifient quels niveaux de résolution de page l'imprimante prend en charge.

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)

Valeur de propriété

ReadOnlyCollection<PageResolution>

ReadOnlyCollection<T> d'objets PageResolution. Chaque valeur représente une résolution de page, en valeur qualitative, exprimée en points par pouce, ou les deux.

Exemples

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

foreach (PageResolution pageRes in pc.PageResolutionCapability)  
    {  
        if (pageRes.QualitativeResolution == PageQualitativeResolution.High)  
        {  
            Console.WriteLine("High quality is supported");  
            break;  
        }  
    }  

Remarques

La plupart des propriétés dont PrintCapabilities la valeur est « Capacité » à la fin du nom, par exemple 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 passé à celui-ci est identique à l’adresse d’un objet dans la collection; autrement dit, il s’agit du même objet. Comme cela ne sera généralement pas le cas, la méthode retourne presque toujours false , 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 PageResolutionCapability, vous devez énumérer chacun de ses membres, en les comparant à la valeur souhaitée. Consultez l'exemple.

La PageResolution classe a des propriétés dans lesquelles vous pouvez spécifier les points par pouce pour les dimensions X et Y et une propriété dans laquelle vous pouvez donner une expression qualitative à la résolution.

Si l’imprimante ne prend pas en charge les choix de résolution de page, la collection est vide.

Cette propriété correspond au mot clé PrintPageResolution Schema.