PrintCapabilities.PageMediaSizeCapability Proprietà

Definizione

Spazio dei nomi:

System.Printing

Assembly:

ReachFramework.dll

Ottiene un insieme di oggetti PageMediaSize che identificano la carta e le dimensioni dei supporti utilizzati dalla stampante.

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)

Valore della proprietà

ReadOnlyCollection<PageMediaSize>

ReadOnlyCollection<T> di oggetti PageMediaSize.

Esempio

Nell'esempio di codice seguente viene illustrato come cercare un valore specifico in PageMediaSizeCapability.

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

Commenti

La maggior parte delle proprietà di PrintCapabilities che hanno "Capability" alla fine del nome, ad esempio CollationCapability, sono raccolte di valori di un tipo enumerato. Ma PageMediaSizeCapability e PageResolutionCapability sono raccolte di oggetti. Per le ultime due proprietà, non è possibile verificare la presenza di un determinato valore usando il metodo Contains di ReadOnlyCollection<T>. Ciò è dovuto al fatto che, con i tipi di riferimento, il metodo restituisce true solo quando l'indirizzo di memoria dell'oggetto passato è uguale all'indirizzo di un oggetto nell'insieme, ovvero lo stesso oggetto. Poiché in genere questo non avviene, il metodo restituirà false quasi sempre anche se nell'insieme è presente un oggetto con esattamente gli stessi valori in tutte le relative proprietà come l'oggetto passato al metodo Contains di ReadOnlyCollection<T>. Per determinare il contenuto di PageMediaSizeCapability, è necessario enumerare ognuno dei relativi membri, confrontandoli con il valore desiderato.

Se la stampante non supporta la selezione delle dimensioni dei supporti, la raccolta è vuota.

Questa proprietà corrisponde alla parola chiave dello schema di PageMediaSize stampa.