PrintCapabilities.PageResolutionCapability Proprietà

Definizione

Spazio dei nomi:

System.Printing

Assembly:

ReachFramework.dll

Ottiene un insieme di oggetti PageResolution che identificano i livelli di risoluzione della pagina supportati dalla stampante.

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)

Valore della proprietà

ReadOnlyCollection<PageResolution>

ReadOnlyCollection<T> di oggetti PageResolution. Ciascun valore rappresenta la risoluzione della pagina come un valore qualitativo, un valore punti per pollice o in entrambi i modi.

Esempio

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

foreach (PageResolution pageRes in pc.PageResolutionCapability)
    {
        if (pageRes.QualitativeResolution == PageQualitativeResolution.High)
        {
            Console.WriteLine("High quality 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 PageResolutionCapability, è necessario enumerare ognuno dei relativi membri, confrontandoli con il valore desiderato. Vedere l'esempio.

La PageResolution classe dispone di proprietà in cui è possibile specificare i punti per pollice per le dimensioni X e Y e una proprietà in cui è possibile assegnare un'espressione qualitativa alla risoluzione.

Se la stampante non supporta le scelte di risoluzione delle pagine, la raccolta è vuota.

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