PrintCapabilities.PageMediaSizeCapability Propiedad

Definición

Espacio de nombres:

System.Printing

Ensamblado:

ReachFramework.dll

Obtiene una colección de objetos PageMediaSize que identifican los tamaños del papel y de los soportes que una impresora admite.

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)

Valor de propiedad

ReadOnlyCollection<PageMediaSize>

Clase ReadOnlyCollection<T> de objetos PageMediaSize.

Ejemplos

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

foreach (PageMediaSize mediaSize in pc.PageMediaSizeCapability)
    {
        if (mediaSize.PageMediaSizeName == PageMediaSizeName.ISOA4)
        {
            Console.WriteLine("A4 size 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 PageMediaSizeCapability, debe enumerar a través de cada uno de sus miembros, comparándolos con el valor deseado.

Si la impresora no admite la selección del tamaño del medio, la colección está vacía.

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