Partilhar via


PrintManager.ShowPrintUIAsync Método

Definição

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

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

Atributos

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.

Aplica-se a

Confira também