PrintCapabilities.PageResolutionCapability Właściwość

Definicja

Przestrzeń nazw:

System.Printing

Zestaw:

ReachFramework.dll

Pobiera kolekcję PageResolution obiektów, które identyfikują poziomy rozdzielczości strony obsługiwanej przez drukarkę.

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)

Wartość właściwości

ReadOnlyCollection<PageResolution>

Obiekt typu PageResolution .ReadOnlyCollection<T> Każda wartość reprezentuje rozdzielczość strony jako wartość jakościową, wartość kropkową na cal lub obie te wartości.

Przykłady

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

foreach (PageResolution pageRes in pc.PageResolutionCapability)
    {
        if (pageRes.QualitativeResolution == PageQualitativeResolution.High)
        {
            Console.WriteLine("High quality 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>. Jest to spowodowane tym, że w przypadku typów odwołań metoda zwraca true tylko wtedy, gdy adres pamięci obiektu przekazanego do niego jest taki sam jak adres obiektu w kolekcji; oznacza to, że są one tym samym obiektem. Ponieważ zwykle nie będzie tak, metoda będzie prawie zawsze zwracana false , nawet jeśli w kolekcji znajduje się obiekt z dokładnie tymi samymi wartościami we wszystkich jej właściwościach, co obiekt przekazany do metody Contains klasy ReadOnlyCollection<T>. Aby określić zawartość elementu PageResolutionCapability, należy wyliczyć poszczególne elementy członkowskie, porównując je z żądaną wartością. Zobacz przykład.

Klasa PageResolution ma właściwości, w których można określić kropki na cal dla wymiarów X i Y oraz właściwość, w której można nadać wyrażenie jakościowe do rozdzielczości.

Jeśli drukarka nie obsługuje opcji rozpoznawania stron, kolekcja jest pusta.

Ta właściwość odpowiada słowu kluczowemu Print Schema.PageResolution