PrintCapabilities.PageResolutionCapability 属性

定义

命名空间:

System.Printing

程序集:

ReachFramework.dll

获取 PageResolution 对象的集合，这些对象用于标识打印机支持的页面分辨率的等级。

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)

属性值

ReadOnlyCollection<PageResolution>

一个由 ReadOnlyCollection<T> 对象构成的 PageResolution。 每一个值以定性值和/或每英寸点数值来表示页面分辨率。

示例

下面的代码示例演示如何在 中 PageResolutionCapability搜索特定值。

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

注解

名称末尾具有“Capability”的大多数属性 PrintCapabilities （例如 CollationCapability），都是枚举类型的值的集合。 但 PageMediaSizeCapability 和 PageResolutionCapability 是对象的集合。 对于后两个属性，无法使用 的 Contains 方法 ReadOnlyCollection<T>测试是否存在特定值。 这是因为，对于引用类型，仅当传递给它的 对象的内存地址与集合中对象的地址相同时，方法才返回 true ;也就是说，它们是同一对象。 由于这种情况通常不是这样，因此即使集合中有一个 对象在其所有属性中具有与传递给 Contains 方法的对象ReadOnlyCollection<T>完全相同的值，该方法也几乎始终返回 false 。 若要确定 的内容 PageResolutionCapability，必须枚举其每个成员，并将其与所需值进行比较。 请参阅示例。

类 PageResolution 具有可以指定 X 和 Y 尺寸的每英寸点数的属性，以及一个属性，可在其中为分辨率提供定性表达式。

如果打印机不支持页面分辨率选项，则集合为空。

此属性对应于打印架构的PageResolution关键字 (keyword) 。