PrintCapabilities.PageResolutionCapability Propiedad

Definición

Espacio de nombres:

System.Printing

Ensamblado:

ReachFramework.dll

Obtiene una colección de objetos PageResolution que identifican qué niveles de resolución de página admite la impresora.

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)

Valor de propiedad

ReadOnlyCollection<PageResolution>

Clase ReadOnlyCollection<T> de objetos PageResolution. Cada valor representa una resolución de página como un valor cualitativo, un valor de puntos por pulgada o ambos.

Ejemplos

En el ejemplo de código siguiente se muestra cómo buscar un valor determinado en .PageResolutionCapability

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

Comentarios

La mayoría de las propiedades de PrintCapabilities que tienen "Capability" al final del nombre, como CollationCapability, son colecciones de valores de un tipo enumerado. Pero PageMediaSizeCapability y PageResolutionCapability son colecciones de objetos. Para las dos últimas propiedades, no se puede probar la presencia de un valor determinado mediante el método Contains de ReadOnlyCollection<T>. Esto se debe a que, con tipos de referencia, el método devuelve true solo cuando la dirección de memoria del objeto pasado a él es la misma que la dirección de un objeto de la colección; es decir, son el mismo objeto. Dado que esto no suele ser el caso, el método casi siempre devolverá false incluso si hay un objeto en la colección con exactamente los mismos valores en todas sus propiedades que el objeto pasado al método Contains de ReadOnlyCollection<T>. Para determinar el contenido de PageResolutionCapability, debe enumerar a través de cada uno de sus miembros, comparándolos con el valor deseado. Vea el ejemplo siguiente.

La PageResolution clase tiene propiedades en las que se pueden especificar los puntos por pulgada para las dimensiones X e Y y una propiedad donde se puede proporcionar una expresión cualitativa a la resolución.

Si la impresora no admite opciones de resolución de página, la colección está vacía.

Esta propiedad corresponde a la palabra clave del esquema de PageResolution impresión.