PrintCapabilities.PageResolutionCapability プロパティ

定義

プリンターでサポートされているページ解像度のレベルを識別する 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<T> オブジェクトのPageResolution。 各値は、定性値、ドット/インチ値、またはその両方としてページ解像度を表します。

次のコード例は、 PageResolutionCapability内の特定の値を検索する方法を示しています。

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

注釈

名前の末尾に "Capability" を持つ PrintCapabilities のほとんどのプロパティ ( CollationCapability など) は、列挙型の値のコレクションです。 ただし、 PageMediaSizeCapabilityPageResolutionCapability はオブジェクトのコレクションです。 後者の 2 つのプロパティでは、ReadOnlyCollection<T>Contains メソッドを使用して、特定の値の存在をテストすることはできません。 これは、参照型では、渡されたオブジェクトのメモリ アドレスがコレクション内のオブジェクトのアドレスと同じである場合にのみ、メソッドは true を返します。つまり、同じオブジェクトであるためです。 通常、これは当てはまるわけではないため、コレクション内に、ReadOnlyCollection<T>Contains メソッドに渡されるオブジェクトとまったく同じ値を持つオブジェクトがすべてのプロパティに存在する場合でも、メソッドはほとんどの場合、falseを返します。 PageResolutionCapabilityの内容を特定するには、各メンバーを列挙し、それらを目的の値と比較する必要があります。 例を参照してください。

PageResolution クラスには、X および Y 次元の 1 インチあたりのドット数を指定できるプロパティと、解像度に定性的な式を指定できるプロパティがあります。

プリンターがページ解像度の選択をサポートしていない場合、コレクションは空です。

このプロパティは、 印刷スキーマPageResolution キーワードに対応します。

適用対象