PrintCapabilities.PageMediaSizeCapability プロパティ

定義

名前空間:

System.Printing

アセンブリ:

ReachFramework.dll

プリンターでサポートされている用紙やメディアのサイズを識別する PageMediaSize オブジェクトのコレクションを取得します。

public:
 property System::Collections::ObjectModel::ReadOnlyCollection<System::Printing::PageMediaSize ^> ^ PageMediaSizeCapability { System::Collections::ObjectModel::ReadOnlyCollection<System::Printing::PageMediaSize ^> ^ get(); };

public System.Collections.ObjectModel.ReadOnlyCollection<System.Printing.PageMediaSize> PageMediaSizeCapability { get; }

member this.PageMediaSizeCapability : System.Collections.ObjectModel.ReadOnlyCollection<System.Printing.PageMediaSize>

Public ReadOnly Property PageMediaSizeCapability As ReadOnlyCollection(Of PageMediaSize)

プロパティ値

ReadOnlyCollection<PageMediaSize>

ReadOnlyCollection<T> オブジェクトの PageMediaSize。

例

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

foreach (PageMediaSize mediaSize in pc.PageMediaSizeCapability)
    {
        if (mediaSize.PageMediaSizeName == PageMediaSizeName.ISOA4)
        {
            Console.WriteLine("A4 size is supported");
            break;
        }
    }

注釈

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

プリンターがメディア サイズの選択をサポートしていない場合、コレクションは空です。

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