PrintCapabilities.PageMediaSizeCapability Vlastnost

Definice

Obor názvů:

System.Printing

Sestavení:

ReachFramework.dll

Získá kolekci PageMediaSize objektů, které identifikují formáty papíru a médií, které tiskárna podporuje.

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)

Hodnota vlastnosti

ReadOnlyCollection<PageMediaSize>

A ReadOnlyCollection<T> objektů PageMediaSize .

Příklady

Následující příklad kódu ukazuje, jak vyhledat konkrétní hodnotu v PageMediaSizeCapabilitysouboru .

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

Poznámky

Většina vlastností PrintCapabilities , které mají na konci názvu "Capability", například CollationCapability, jsou kolekce hodnot výčtového typu. Ale PageMediaSizeCapability a PageResolutionCapability jsou kolekce objektů. U posledních dvou vlastností nelze testovat přítomnost konkrétní hodnoty pomocí metody Contains pro ReadOnlyCollection<T>. Je to proto, že u referenčních typů vrátí true metoda pouze tehdy, když je adresa paměti objektu předaná do ní stejná jako adresa objektu v kolekci; to znamená, že se jedná o stejný objekt. Vzhledem k tomu, že to obvykle nebude tento případ, vrátí metoda téměř vždy false i v případě, že v kolekci existuje objekt s přesně stejnými hodnotami ve všech svých vlastnostech jako objekt předaný do Contains metody .ReadOnlyCollection<T> Chcete-li zjistit obsah objektu PageMediaSizeCapability, je nutné vytvořit výčet prostřednictvím jednotlivých jeho členů a porovnat je s požadovanou hodnotou.

Pokud tiskárna nepodporuje výběr velikosti média, je kolekce prázdná.

Tato vlastnost odpovídá klíčovému slovu Print SchemaPageMediaSize.