PrintTaskConfiguration Класс
Определение
Важно!
Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.
Позволяет клиенту получить контекст расширения задачи печати, а также добавить обработчик событий в задачу печати.
public ref class PrintTaskConfiguration sealed
/// [Windows.Foundation.Metadata.ContractVersion(Windows.Devices.Printers.Extensions.ExtensionsContract, 65536)]
class PrintTaskConfiguration final
[Windows.Foundation.Metadata.ContractVersion(typeof(Windows.Devices.Printers.Extensions.ExtensionsContract), 65536)]
public sealed class PrintTaskConfiguration
Public NotInheritable Class PrintTaskConfiguration
- Наследование
- Атрибуты
Требования к Windows
Семейство устройств |
Windows Desktop Extension SDK (появилось в 10.0.10240.0)
|
API contract |
Windows.Devices.Printers.Extensions.ExtensionsContract (появилось в v1.0)
|
Комментарии
Когда приложение UWP вызывается из дополнительных параметров в окне печати, событие активации предоставляет аргумент события типа Windows.UI.WebUI.WebUIPrintTaskSettingsActivatedEventArgs , который предоставляет свойство Configuration для управления принтером. Это свойство предоставляет объект типа PrintTaskConfiguration , который предоставляет доступ к контексту расширения задачи печати, а также позволяет добавить обработчик событий для обновления билета печати.
В следующем фрагменте кода JavaScript показано, как получить доступ к объекту PrintTaskConfiguration , а затем использовать его для доступа к свойству PrinterExtensionContext .
var configuration;
var printerExtesionContext;
function displayPrintSettings() {
if (!configuration) {
sdkSample.displayError("Configuration argument is null");
return;
}
printerExtesionContext = configuration.printerExtensionContext;
printHelper = new Microsoft.Samples.Printing.WwaDca.
PrintHelperClass(printerExtensionContext);
var feature = "PageOrientation";
// if printer's capabilities include this feature.
if (!printHelper.featureExists(feature)) {
continue;
}
// Get the selected option for this feature in the current
// context's print ticket.
var selectedOption = printHelper.getSelectedOptionIndex(feature);
// Get the array of options in the current context’s print ticket
var optionIndex = printHelper.getOptionInfo(feature, "Index"),
var optionNames = printHelper.getOptionInfo(feature,
"DisplayName"),
var selectedName;
for (var i = 0; i < optionIndex.length; i++) {
if (optionIndex[i] === selectedOption)
selectedName = optionNames[i];
// logic to display the orientation string here
}
Свойства
PrinterExtensionContext |
Возвращает контекст для расширения задачи печати. |
События
SaveRequested |
Вызывается окном печати для вашего приложения, чтобы уведомить приложение устройства о необходимости обновления билета на печать. |