PrintTaskSourceRequestedHandler Delegado
Definición
Importante
Parte de la información hace referencia a la versión preliminar del producto, que puede haberse modificado sustancialmente antes de lanzar la versión definitiva. Microsoft no otorga ninguna garantía, explícita o implícita, con respecto a la información proporcionada aquí.
Se produce cuando una tarea de impresión solicita al documento que se imprima. El documento de impresión proporcionado debe implementar la interfaz 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
Puntero a un objeto PrintTaskSourceRequestedArgs .
- Atributos
Requisitos de Windows
| Familia de dispositivos |
Windows 10 (se introdujo en la versión 10.0.10240.0 - for Xbox, see UWP features that aren't yet supported on Xbox)
|
| API contract |
Windows.Foundation.UniversalApiContract (se introdujo en la versión v1.0)
|
Comentarios
Se llama a PrintTaskSourceRequestedHandler para completar la inicialización de un objeto PrintTask . Este modelo de inicialización en dos fases está diseñado para permitir que una aplicación responda rápidamente al evento PrintTaskRequested mediante la creación del objeto PrintTask . Después, cuando se invoca realmente la impresión, PrintTaskSourceRequestedHandler realiza el trabajo necesario para preparar el contenido que se va a obtener en vista previa y, finalmente, imprimirlo. La fecha límite para completar el trabajo en PrintTaskSourceRequestedHandler es mucho mayor que la fecha límite para completar el trabajo en el controlador PrintTaskRequested .
Por ejemplo, considere una aplicación que necesite descargar información de la nube para completar la operación de impresión de los detalles de un pase de embarque. La aplicación debe responder rápidamente al evento PrintTaskRequested mediante la creación de un objeto PrintTask y un nombre para la operación de impresión, por ejemplo, "Pase de embarque de Fabrikam". A continuación, la aplicación proporciona PrintTaskSourceRequestedHandler con un puntero al objeto PrintTask . Cuando se invoca este controlador, la aplicación inicia la llamada para recuperar el contenido real del pase de embarque para que se pueda realizar la vista previa e impresión de impresión.
Una aplicación tiene dos opciones para crear un objeto de origen del documento de impresión:
- Use un origen de documento de impresión proporcionado por el marco. Los marcos HTML5/JavaScript y XAML proporcionan implementaciones de objetos que implementan la interfaz IPrintDocumentSource . Para las aplicaciones HTML5/JavaScript, consulte MSApp.getHtmlPrintDocumentSource. Para obtener información sobre el desarrollo de aplicaciones compatibles con impresión con el lenguaje de marcado extensible de aplicaciones (XAML), consulta Windows.UI.Xaml.Printing.PrintDocument.
- Proporcione un origen de documento de impresión personalizado. Una aplicación puede optar por proporcionar su propia implementación personalizada de un objeto IPrintDocumentSource . Esto requiere una buena comprensión de Direct2D o las API XPS. Para obtener un ejemplo de cómo una aplicación puede proporcionar su propio origen de documento de impresión personalizado, consulte el ejemplo de impresión D2D.