Поделиться через


PrintTaskOptions Класс

Определение

Представляет коллекцию методов и свойств для управления параметрами, определяющими способ печати содержимого.

public ref class PrintTaskOptions sealed : IPrintTaskOptionsCore, IPrintTaskOptionsCoreProperties, IPrintTaskOptionsCoreUIConfiguration
/// [Windows.Foundation.Metadata.ContractVersion(Windows.Foundation.UniversalApiContract, 65536)]
/// [Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
class PrintTaskOptions final : IPrintTaskOptionsCore, IPrintTaskOptionsCoreProperties, IPrintTaskOptionsCoreUIConfiguration
[Windows.Foundation.Metadata.ContractVersion(typeof(Windows.Foundation.UniversalApiContract), 65536)]
[Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
public sealed class PrintTaskOptions : IPrintTaskOptionsCore, IPrintTaskOptionsCoreProperties, IPrintTaskOptionsCoreUIConfiguration
Public NotInheritable Class PrintTaskOptions
Implements IPrintTaskOptionsCore, IPrintTaskOptionsCoreProperties, IPrintTaskOptionsCoreUIConfiguration
Наследование
Object Platform::Object IInspectable PrintTaskOptions
Атрибуты
Реализации

Требования к Windows

Семейство устройств
Windows 10 (появилось в 10.0.10240.0 - for Xbox, see UWP features that aren't yet supported on Xbox)
API contract
Windows.Foundation.UniversalApiContract (появилось в v1.0)

Комментарии

Класс PrintTaskOptions предоставляет доступ к различным значениям, определяющим форматирование содержимого задачи печати во время печати. Объект PrintTaskOptions может содержать такие сведения, как размер печатной страницы, ее ориентация и тип носителя, на котором будет печататься содержимое. Кроме того, объект PrintTaskOptions предоставляет доступ к списку параметров, отображаемых в окне печати.

Хотя каждый параметр в PrintTaskOptions, например MediaSize или MediaType, имеет определенный набор поддерживаемых значений, все параметры поддерживают один и тот же общий шаблон для представления некоторых распространенных вариантов. Распространенные значения регистра: Default, NotAvailable и PrinterCustom.

Каждый параметр содержит значение по умолчанию, которое присваивается параметру целевым объектом печати. Если это значение извлекается через доступ к свойству, это означает, что целевой объект печати еще не определил фактическое значение для этого параметра. Если задать значение по умолчанию для определенного параметра, он указывает целевому объекту печати, что он должен использовать значение по умолчанию для этого параметра. Если для этого параметра нет значения по умолчанию, значение параметра остается неизменным.

Параметр также может сообщить о значении NotAvailable . Это означает, что конкретный параметр недоступен для выбранного в данный момент целевого объекта печати. Например, если свойство Duplex возвращает значение NotAvailable , оно указывает, что целевой объект печати не поддерживает дуплексные функции. Невозможно задать для параметра значение NotAvailable .

Окончательное значение, общее для всех параметров, — PrinterCustom. Это означает, что целевой объект печати поддерживает функциональные возможности, но текущий выбор является пользовательским для этого принтера. Например, целевой объект печати может поддерживать специальный метод привязки документа, который не является одним из стандартных значений. В этом случае запрос свойства для параметра Binding вернет значение PrinterCustom . Пользовательские размеры выходных данных также будут представлены в виде значений PrinterCustom , но фактические физические размеры по-прежнему будут доступны с помощью метода GetPageDescription .

Приложение также может использовать PrintTaskOptions для настройки параметров, отображаемых в окне печати. Свойство DisplayedOptions возвращает вектор, содержащий список отображаемых элементов параметров. Изменения в этом списке путем вставки, добавления, удаления или изменения порядка будут отражены в окне печати. Если конкретный целевой объект печати не поддерживает параметр, параметр не будет отображаться для пользователя. Имена стандартных параметров см. в разделе StandardPrintTaskOptions.

Ниже приведен фрагмент кода, который можно использовать, например, для задания цветных выходных данных, а также для задания размера носителя, на котором они могут быть напечатаны. Доступ PrintTaskOptions к объекту осуществляется через свойство PrintTask.Options .

// Set output to color
printTask.Options.ColorMode = PrintColorMode.Color;

// Set the media size for printing
printTask.Options.MediaSize = PrintMediaSize.NorthAmericaLegal;

Дополнительные сведения о допустимых значениях для этих параметров задачи печати см. в разделах PrintColorMode и PrintMediaSize.

Журнал версий

Версия Windows Версия пакета SDK Добавленная стоимость
1607 14393 Граничащих
1607 14393 GetPagePrintTicket
1803 17134 CustomPageRanges
1803 17134 PageRangeOptions

Свойства

Binding

Возвращает или задает параметр привязки для задачи печати.

Bordering

Возвращает или задает параметр границы для задачи печати.

Collation

Возвращает или задает параметр сортировки задач печати.

ColorMode

Возвращает или задает параметр цветового режима задачи печати.

CustomPageRanges

Возвращает параметры настраиваемого диапазона страниц для задачи печати.

DisplayedOptions

Возвращает список параметров, отображаемых для печати.

Duplex

Возвращает или задает дуплексный параметр задачи печати.

HolePunch

Возвращает или задает параметр перфоратора для задачи печати.

MaxCopies

Возвращает максимальное число копий, поддерживаемых для задачи печати.

MediaSize

Возвращает или задает параметр размера носителя задачи печати.

MediaType

Возвращает или задает параметр типа носителя для задачи печати.

MinCopies

Возвращает минимальное количество копий, разрешенных для задачи печати.

NumberOfCopies

Возвращает или задает значение количества копий для задачи печати.

Orientation

Возвращает или задает параметр ориентации для задачи печати.

PageRangeOptions

Возвращает параметры диапазона страниц для задачи печати.

PrintQuality

Возвращает или задает параметр качества печати для задачи печати.

Staple

Возвращает или задает параметр скобы для задачи печати.

Методы

GetPageDescription(UInt32)

Извлекает физические размеры печатной страницы.

GetPagePrintTicket(PrintPageInfo)

Извлекает физические размеры и данные форматирования печатной страницы.

Применяется к

См. также раздел