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。 それぞれの値は、定性的な値、ドット/インチ (dpi)、またはその両方でページ解像度を表します。

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

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

注釈

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

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

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

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

適用対象