PrintCapabilities.PageMediaSizeCapability Свойство

Определение

Пространство имен:

System.Printing

Сборка:

ReachFramework.dll

Возвращает коллекцию объектовPageMediaSize, указывающих размеры бумаги и носителей, поддерживаемые принтером.

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)

Значение свойства

ReadOnlyCollection<PageMediaSize>

Коллекция ReadOnlyCollection<T> объектов PageMediaSize.

Примеры

В следующем примере кода показано, как выполнить поиск определенного значения в PageMediaSizeCapability.

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

Комментарии

Большинство свойств , PrintCapabilities имеющих "Capability" в конце имени, например CollationCapability, являются коллекциями значений перечисленного типа. Но PageMediaSizeCapability и PageResolutionCapability являются коллекциями объектов . Для двух последних свойств невозможно проверить наличие определенного значения с помощью метода Contains объекта ReadOnlyCollection<T>. Это связано с тем, что при использовании ссылочных типов метод возвращает true только в том случае, если адрес памяти переданного объекта совпадает с адресом объекта в коллекции, то есть они являются тем же объектом. Так как обычно это не так, метод почти всегда возвращает, false даже если в коллекции есть объект со значениями во всех своих свойствах, что и объект, переданный методу Contains .ReadOnlyCollection<T> Чтобы определить содержимое PageMediaSizeCapability, необходимо выполнить перечисление по каждому его члену, сравнивая их с нужным значением.

Если принтер не поддерживает выбор размера носителя, коллекция пуста.

Это свойство соответствует ключевое слово схемыPageMediaSize печати.