PrintCapabilities.PageMediaSizeCapability Vlastnost
Definice
Důležité
Některé informace platí pro předběžně vydaný produkt, který se může zásadně změnit, než ho výrobce nebo autor vydá. Microsoft neposkytuje žádné záruky, výslovné ani předpokládané, týkající se zde uváděných informací.
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
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
.