PrintManager.ShowPrintUIAsync Método

Definição

Namespace:

Windows.Graphics.Printing

Inicia programaticamente a interface do usuário para imprimir conteúdo.

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)

Retornos

IAsyncOperation<Boolean>

IAsyncOperation<bool>

Um valor booliano para indicar um TRUE para êxito ou false para uma falha.

Atributos

RemoteAsyncAttribute

Comentários

Esse método pode ser usado por um aplicativo que já usou GetForCurrentView para recuperar a instância printManager e registrou um ouvinte para o evento PrintTaskRequested para iniciar a experiência do usuário de impressão. ShowPrintUIAsync exibe a janela de impressão apropriada. Se a impressão não puder ser executada nesse momento, o método gerará uma exceção. É recomendável capturar essas exceções e informar ao usuário quando a impressão não pode continuar, conforme mostrado aqui.

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();
    }
}

Neste exemplo, uma janela de impressão é exibida no manipulador de eventos para um clique de botão. Se o método abrir uma exceção (porque a impressão não pôde ser executada naquele momento), um controle ContentDialog informa o usuário sobre a situação. Para obter mais informações sobre impressão do seu aplicativo, consulte Impressão.

Confira também

• Impressão