PrintTaskSourceRequestedHandler 代理人

  • リファレンス

定義

名前空間:
Windows.Graphics.Printing
編集

印刷タスクが文書の印刷を要求したときに発生します。 指定された印刷ドキュメントは 、IPrintDocumentSource インターフェイスを実装する必要があります。

public delegate void PrintTaskSourceRequestedHandler(PrintTaskSourceRequestedArgs ^ args);
/// [Windows.Foundation.Metadata.ContractVersion(Windows.Foundation.UniversalApiContract, 65536)]
/// [Windows.Foundation.Metadata.Guid(1813028776, 23734, 19258, 134, 99, 243, 156, 176, 45, 201, 180)]
class PrintTaskSourceRequestedHandler : MulticastDelegate
[Windows.Foundation.Metadata.ContractVersion(typeof(Windows.Foundation.UniversalApiContract), 65536)]
[Windows.Foundation.Metadata.Guid(1813028776, 23734, 19258, 134, 99, 243, 156, 176, 45, 201, 180)]
public delegate void PrintTaskSourceRequestedHandler(PrintTaskSourceRequestedArgs args);
var printTaskSourceRequestedHandlerHandler = function(args){
/* Your code */
}
Public Delegate Sub PrintTaskSourceRequestedHandler(args As PrintTaskSourceRequestedArgs)

パラメーター

args
PrintTaskSourceRequestedArgs

PrintTaskSourceRequestedArgs オブジェクトへのポインター。

属性
ContractVersionAttribute GuidAttribute

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 で導入)

注釈

PrintTaskSourceRequestedHandler は、 PrintTask オブジェクトの初期化を完了するために呼び出されます。 この 2 フェーズ初期化モデルは、PrintTask オブジェクトを作成することで、アプリが PrintTaskRequested イベントにすばやく応答できるように設計されています。 その後、印刷が実際に呼び出されると、 PrintTaskSourceRequestedHandler は、プレビューして最終的に印刷するコンテンツを準備するために必要な作業を行います。 PrintTaskSourceRequestedHandler での作業の完了期限は、 PrintTaskRequested ハンドラーでの作業の完了期限よりもはるかに大きくなります。

たとえば、クラウドから情報をダウンロードして、搭乗券の詳細の印刷操作を完了する必要があるアプリを考えてみましょう。 アプリは 、PrintTask オブジェクトと印刷操作の名前 (例: "Fabrikam ボーディング パス") を作成することで、 PrintTaskRequested イベントにすばやく応答する必要があります。その後、アプリは PrintTaskSourceRequestedHandler に PrintTask オブジェクトのポインターを提供します。 このハンドラーが呼び出されると、アプリは、印刷プレビューと印刷を実行できるように、搭乗券の実際のコンテンツを取得する呼び出しを開始します。

アプリには、印刷ドキュメント ソース オブジェクトを作成するための 2 つのオプションがあります。

  • フレームワーク提供の印刷ドキュメント ソースを使用します。 HTML5/JavaScript フレームワークと XAML フレームワークはどちらも、 IPrintDocumentSource インターフェイスを実装するオブジェクトの実装を提供します。 HTML5/JavaScript アプリについては、「 MSApp.getHtmlPrintDocumentSource」を参照してください。 拡張可能なアプリケーション マークアップ言語 (XAML) を使用した印刷対応アプリの開発については、「 Windows.UI.Xaml.Printing.PrintDocument」を参照してください。
  • ユーザー設定の印刷ドキュメント ソースを指定します。 アプリは、 IPrintDocumentSource オブジェクトの独自のカスタム実装を提供することを選択できます。 そのためには、Direct2D や XPS API を十分に理解する必要があります。 アプリで独自のカスタム印刷ドキュメント ソースを提供する方法の例については、 D2D 印刷のサンプルを参照してください。

適用対象

こちらもご覧ください