Partager via


PrintCapabilities.PageResolutionCapability Propriété

Définition

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<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 .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 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 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é du PageResolutionschéma d’impression.

S’applique à