PrintTaskSourceRequestedHandler Delegato
Definizione
Importante
Alcune informazioni sono relative alla release non definitiva del prodotto, che potrebbe subire modifiche significative prima della release definitiva. Microsoft non riconosce alcuna garanzia, espressa o implicita, in merito alle informazioni qui fornite.
Si verifica quando un'attività di stampa richiede la stampa del documento. Il documento di stampa fornito deve implementare l'interfaccia 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)Parametri
Puntatore a un oggetto PrintTaskSourceRequestedArgs .
- Attributi
Requisiti Windows
| Famiglia di dispositivi |
Windows 10 (è stato introdotto in 10.0.10240.0 - for Xbox, see UWP features that aren't yet supported on Xbox)
|
| API contract |
Windows.Foundation.UniversalApiContract (è stato introdotto in v1.0)
|
Commenti
PrintTaskSourceRequestedHandler viene chiamato per completare l'inizializzazione di un oggetto PrintTask . Questo modello di inizializzazione in due fasi è progettato per consentire a un'app di rispondere rapidamente all'evento PrintTaskRequested creando l'oggetto PrintTask . Successivamente, quando la stampa viene effettivamente richiamata, PrintTaskSourceRequestedHandler esegue il lavoro necessario per preparare il contenuto da visualizzare in anteprima e alla fine stampare. La scadenza per il completamento del lavoro in PrintTaskSourceRequestedHandler è molto superiore alla scadenza per il completamento del lavoro nel gestore PrintTaskRequested .
Si consideri, ad esempio, un'app che deve scaricare informazioni dal cloud per completare l'operazione di stampa per i dettagli di una carta d'imbarco. L'app deve rispondere rapidamente all'evento PrintTaskRequested creando un oggetto PrintTask e un nome per l'operazione di stampa, ad esempio "Fabrikam Boarding Pass". L'app fornisce quindi PrintTaskSourceRequestedHandler con un puntatore all'oggetto PrintTask . Quando questo gestore viene richiamato dall'app, avvia la chiamata per recuperare il contenuto effettivo del passaggio di imbarco in modo che sia possibile eseguire l'anteprima di stampa e la stampa.
Un'app offre due opzioni per la creazione di un oggetto origine documento di stampa:
- Usare un'origine documento di stampa fornita da un framework. Sia i framework HTML5/JavaScript che XAML forniscono implementazioni di oggetti che implementano l'interfaccia IPrintDocumentSource . Per le app HTML5/JavaScript, vedere MSApp.getHtmlPrintDocumentSource. Per informazioni sullo sviluppo di app che supportano la stampa con il linguaggio XAML (Extensible Application Markup Language), vedi Windows.UI.Xaml.Printing.PrintDocument.
- Specificare un'origine documento di stampa personalizzata. Un'app può scegliere di fornire la propria implementazione personalizzata di un oggetto IPrintDocumentSource . Questa operazione richiede una buona conoscenza delle API Direct2D e/o XPS. Per un esempio di come un'app può fornire una propria origine documento di stampa personalizzata, vedere l'esempio di stampa D2D.