PrintTaskSourceRequestedHandler Delegar
Definição
Importante
Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.
Ocorre quando uma tarefa de impressão solicita que o documento seja impresso. O documento de impressão fornecido deve implementar a interface 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)Parâmetros
Ponteiro para um objeto PrintTaskSourceRequestedArgs .
- Atributos
Requisitos do Windows
| Família de dispositivos |
Windows 10 (introduzida na 10.0.10240.0 - for Xbox, see UWP features that aren't yet supported on Xbox)
|
| API contract |
Windows.Foundation.UniversalApiContract (introduzida na v1.0)
|
Comentários
O PrintTaskSourceRequestedHandler é chamado para concluir a inicialização de um objeto PrintTask . Esse modelo de inicialização em duas fases foi projetado para permitir que um aplicativo responda rapidamente ao evento PrintTaskRequested criando o objeto PrintTask . Posteriormente, quando a impressão é realmente invocada, PrintTaskSourceRequestedHandler faz o trabalho necessário para preparar o conteúdo a ser visualizado e, eventualmente, impresso. O prazo para concluir o trabalho no PrintTaskSourceRequestedHandler é muito maior do que o prazo para concluir o trabalho no manipulador PrintTaskRequested .
Por exemplo, considere um aplicativo que precisa baixar informações da Nuvem para concluir a operação de impressão para obter os detalhes de um cartão de embarque. O aplicativo deve responder rapidamente ao evento PrintTaskRequested criando um objeto PrintTask e um nome para a operação de impressão, por exemplo, "Fabrikam Boarding Pass". Em seguida, o aplicativo fornece PrintTaskSourceRequestedHandler com um ponteiro para o objeto PrintTask . Quando esse manipulador é invocado, o aplicativo inicia a chamada para recuperar o conteúdo real do cartão de embarque para que a visualização de impressão e a impressão possam ser executadas.
Um aplicativo tem duas opções para criar um objeto de origem de documento de impressão:
- Use uma fonte de documento de impressão fornecida pela estrutura. As estruturas HTML5/JavaScript e XAML fornecem implementações de objetos que implementam a interface IPrintDocumentSource . Para aplicativos HTML5/JavaScript, consulte MSApp.getHtmlPrintDocumentSource. Para obter informações sobre como desenvolver aplicativos com capacidade de impressão com a linguagem de marcação de aplicativo extensível (XAML), consulte Windows.UI.Xaml.Printing.PrintDocument.
- Forneça uma fonte de documento de impressão personalizada. Um aplicativo pode optar por fornecer sua própria implementação personalizada de um objeto IPrintDocumentSource . Isso requer uma boa compreensão do Direct2D e/ou das APIs XPS. Para obter um exemplo de como um aplicativo pode fornecer sua própria fonte de documento de impressão personalizada, consulte o exemplo de Impressão D2D.