PrintManager.ShowPrintUIAsync Méthode

Définition

Espace de noms:

Windows.Graphics.Printing

Initie par programmation l’interface utilisateur pour l’impression du contenu.

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)

Retours

IAsyncOperation<Boolean>

IAsyncOperation<bool>

Valeur booléenne pour indiquer un TRUE pour la réussite ou un FALSE pour un échec.

Attributs

RemoteAsyncAttribute

Remarques

Cette méthode peut être utilisée par une application qui a déjà utilisé GetForCurrentView pour récupérer l’instance PrintManager et a inscrit un écouteur pour l’événement PrintTaskRequested afin de lancer l’expérience utilisateur d’impression. ShowPrintUIAsync affiche la fenêtre d’impression appropriée. Si l’impression ne peut pas être effectuée à ce moment-là, la méthode lève une exception. Nous vous recommandons d’intercepter ces exceptions et d’informer l’utilisateur quand l’impression ne peut pas continuer, comme illustré ici.

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

Dans cet exemple, une fenêtre d’impression s’affiche dans le gestionnaire d’événements pour un clic sur un bouton. Si la méthode lève une exception (parce que l’impression ne peut pas être effectuée à ce moment précis), un contrôle ContentDialog informe l’utilisateur de la situation. Pour plus d’informations sur l’impression à partir de votre application, consultez Impression.

Voir aussi

• Impression