PrintManager.ShowPrintUIAsync Método
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í.
Inicia mediante programación la interfaz de usuario para imprimir contenido.
public:
static IAsyncOperation<bool> ^ ShowPrintUIAsync();/// [Windows.Foundation.Metadata.RemoteAsync]
static IAsyncOperation<bool> ShowPrintUIAsync();[Windows.Foundation.Metadata.RemoteAsync]
public static IAsyncOperation<bool> ShowPrintUIAsync();function showPrintUIAsync()Public Shared Function ShowPrintUIAsync () As IAsyncOperation(Of Boolean)Devoluciones
Valor booleano para indicar true para que se complete correctamente o false para un error.
- Atributos
Comentarios
Una aplicación que ya ha usado GetForCurrentView puede usar este método para recuperar la instancia de PrintManager y ha registrado un agente de escucha para el evento PrintTaskRequested para iniciar la experiencia del usuario de impresión. ShowPrintUIAsync muestra la ventana de impresión adecuada. Si no se puede realizar la impresión en ese momento, el método producirá una excepción. Te recomendamos capturar estas excepciones y notificar al usuario cuando no se pueda continuar la impresión, como se muestra aquí.
async private void printButton_Click(object sender, RoutedEventArgs e)
{
try
{
// Show print UI
await Windows.Graphics.Printing.PrintManager.ShowPrintUIAsync();
}
catch
{
// Printing cannot proceed at this time
ContentDialog noPrintingDialog = new ContentDialog()
{
Title = "Printing error",
Content = "\nSorry, printing can't proceed at this time.", PrimaryButtonText = "OK"
};
await noPrintingDialog.ShowAsync();
}
}
En este ejemplo, se muestra una ventana de impresión en el controlador de eventos para un clic de botón. Si el método genera una excepción (porque no se puede realizar la impresión en ese momento), el control ContentDialog informa al usuario de la situación. Para obtener más información sobre la impresión desde la aplicación, consulta Imprimir.