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, IPrintTaskOptionsCoreUIConfigurationPublic NotInheritable Class PrintTaskOptions
Implements IPrintTaskOptionsCore, IPrintTaskOptionsCoreProperties, IPrintTaskOptionsCoreUIConfiguration- Наследование
- Атрибуты
- Реализации
Требования к 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) |
Извлекает физические размеры и данные форматирования печатной страницы. |