PrintManager.ShowPrintUIAsync Método

Definición

Espacio de nombres:

Windows.Graphics.Printing

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

IAsyncOperation<Boolean>

IAsyncOperation<bool>

Valor booleano para indicar true para que se complete correctamente o false para un error.

Atributos

RemoteAsyncAttribute

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.

Consulte también

• Impresión