PrintCapabilities.PageResolutionCapability Свойство

Определение

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

System.Printing

Сборка:

ReachFramework.dll

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

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)

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

ReadOnlyCollection<PageResolution>

Коллекция ReadOnlyCollection<T> объектов PageResolution. Каждое значение представляет разрешение страницы в качественном выражении, в количественном выражении в точках на дюйм или оба представления.

Примеры

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

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

Комментарии

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

Класс PageResolution имеет свойства, в которых можно указать точки на дюйм для измерений X и Y, а также свойство, в котором можно дать качественное выражение разрешению.

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

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