PrintCapabilities.PageResolutionCapability Eigenschaft

Definition

Ruft eine Auflistung von PageResolution-Objekten ab, die identifizieren, welche Seitenauflösungen ein Drucker unterstützt.

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)

Eigenschaftswert

Eine ReadOnlyCollection<T> von PageResolution-Objekten. Jeder Wert stellt eine Seitenauflösung als qualitativen Wert, als DPI-Wert (Dots per Inch, Punkte pro Zoll) oder mit beiden Werten dar.

Beispiele

Im folgenden Codebeispiel wird gezeigt, wie nach einem bestimmten Wert in der PageResolutionCapabilitygesucht wird.

foreach (PageResolution pageRes in pc.PageResolutionCapability)
    {
        if (pageRes.QualitativeResolution == PageQualitativeResolution.High)
        {
            Console.WriteLine("High quality is supported");
            break;
        }
    }

Hinweise

Die meisten Eigenschaften von PrintCapabilities , die am Ende des Namens "Capability" aufweisen, z CollationCapability. B. , sind Auflistungen von Werten eines aufgezählten Typs. Aber PageMediaSizeCapability und PageResolutionCapability sind Auflistungen von -Objekten. Für die letzten beiden Eigenschaften können Sie nicht testen, ob ein bestimmter Wert vorhanden ist, indem Sie die Contains-Methode von ReadOnlyCollection<T>verwenden. Dies liegt daran, dass die Methode bei Verweistypen nur dann zurückgibt true , wenn die Speicheradresse des objekts, das an sie übergeben wird, mit der Adresse eines Objekts in der Auflistung identisch ist. Das heißt, es handelt sich um dasselbe Objekt. Da dies in der Regel nicht der Fall ist, gibt die Methode fast immer zurück false , selbst wenn in der Auflistung ein Objekt mit genau den gleichen Werten in allen Eigenschaften vorhanden ist, die an die Contains-Methode von ReadOnlyCollection<T>übergeben werden. Um den Inhalt von PageResolutionCapabilityzu bestimmen, müssen Sie die einzelnen Member durchlaufen und sie mit dem gewünschten Wert vergleichen. Siehe das Beispiel.

Die PageResolution -Klasse verfügt über Eigenschaften, in denen Sie die Punkte pro Zoll für die X- und Y-Dimensionen angeben können, sowie eine Eigenschaft, mit der Sie der Auflösung einen qualitativen Ausdruck geben können.

Wenn der Drucker keine Seitenauflösungsoptionen unterstützt, ist die Sammlung leer.

Diese Eigenschaft entspricht dem Schlüsselwort (keyword) des DruckschemasPageResolution.

Gilt für: