PrintManager.ShowPrintUIAsync Método
Definição
Importante
Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.
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.