PrintTaskConfiguration クラス
定義
重要
一部の情報は、リリース前に大きく変更される可能性があるプレリリースされた製品に関するものです。 Microsoft は、ここに記載されている情報について、明示または黙示を問わず、一切保証しません。
クライアントが印刷タスク拡張コンテキストを取得し、印刷タスクにイベント ハンドラーを追加できるようにします。
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 PrintTaskConfigurationPublic NotInheritable Class PrintTaskConfiguration- 継承
- 属性
Windows の要件
| デバイス ファミリ |
Windows Desktop Extension SDK (10.0.10240.0 で導入)
|
| API contract |
Windows.Devices.Printers.Extensions.ExtensionsContract (v1.0 で導入)
|
注釈
印刷ウィンドウの [その他の設定] から UWP アプリが呼び出されると、ライセンス認証イベントは、プリンターを制御するためのプロパティ Configuration を公開する Windows.UI.WebUI.WebUIPrintTaskSettingsActivatedEventArgs 型のイベント引数を提供します。 このプロパティは、印刷タスク拡張コンテキストへのアクセスを提供する 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 |
印刷チケットを更新する必要があることをデバイス アプリに通知するために、アプリの印刷ウィンドウによって発生します。 |