PrintCapabilities.PageMediaSizeCapability Właściwość

Definicja

Przestrzeń nazw:

System.Printing

Zestaw:

ReachFramework.dll

Pobiera kolekcję PageMediaSize obiektów identyfikujących rozmiary papieru i nośnika obsługiwane przez drukarkę.

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)

Wartość właściwości

ReadOnlyCollection<PageMediaSize>

A ReadOnlyCollection<T> obiektów PageMediaSize .

Przykłady

Poniższy przykład kodu pokazuje, jak wyszukać określoną wartość w obiekcie PageMediaSizeCapability.

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

Uwagi

Większość właściwości, PrintCapabilities które mają wartość "Capability" na końcu nazwy, takie jak CollationCapability, to kolekcje wartości typu wyliczonego. Ale PageMediaSizeCapability i PageResolutionCapability są kolekcjami obiektów. W przypadku dwóch ostatnich właściwości nie można przetestować obecności określonej wartości przy użyciu metody Contains klasy ReadOnlyCollection<T>. Wynika to z faktu, że w przypadku typów odwołań metoda zwraca wartość true tylko wtedy, gdy adres pamięci obiektu przekazanego do niego jest taki sam jak adres obiektu w kolekcji, czyli jest to ten sam obiekt. Ponieważ zwykle nie będzie tak, metoda będzie prawie zawsze zwracaćfalse, nawet jeśli w kolekcji znajduje się obiekt o dokładnie tych samych wartościach we wszystkich jego właściwościach, co obiekt przekazany do metody Contains .ReadOnlyCollection<T> Aby określić zawartość elementu PageMediaSizeCapability, należy wyliczyć poszczególne jego elementy członkowskie, porównując je z żądaną wartością.

Jeśli drukarka nie obsługuje wyboru rozmiaru nośnika, kolekcja jest pusta.

Ta właściwość odpowiada słowu kluczowemu SchematPageMediaSize wydruku.