PrintCapabilities.PageMediaSizeCapability Eigenschaft

Definition

Ruft eine Auflistung von PageMediaSize-Objekten ab, die die von einem Drucker unterstützten Papier- und Medienformate identifizieren.

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)

Eigenschaftswert

Eine ReadOnlyCollection<T> von PageMediaSize-Objekten.

Beispiele

Das folgende Codebeispiel zeigt, wie Sie nach einem bestimmten Wert in suchen PageMediaSizeCapability.

foreach (PageMediaSize mediaSize in pc.PageMediaSizeCapability)
    {
        if (mediaSize.PageMediaSizeName == PageMediaSizeName.ISOA4)
        {
            Console.WriteLine("A4 size 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 Sammlungen von -Objekten. Für die beiden letztgenannten Eigenschaften können Sie nicht testen, ob ein bestimmter Wert vorhanden ist, indem Sie die Contains-Methode von verwenden ReadOnlyCollection<T>. Dies liegt daran, dass die Methode bei Verweistypen nur dann zurückgibt true , wenn die Speicheradresse des an sie übergebenen Objekts 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 , auch wenn in der Auflistung ein Objekt mit genau den gleichen Werten in allen Eigenschaften vorhanden ist, wie das an die Contains-MethodeReadOnlyCollection<T>von übergebene Objekt. Um den Inhalt von PageMediaSizeCapabilityzu bestimmen, müssen Sie die einzelnen Member auflisten und sie mit dem gewünschten Wert vergleichen.

Wenn der Drucker die Auswahl der Mediengröße nicht unterstützt, ist die Sammlung leer.

Diese Eigenschaft entspricht dem Schlüsselwort (keyword) des Print-SchemasPageMediaSize.

Gilt für: