PrintManager.ShowPrintUIAsync Methode

Referenz

Definition

Namespace:: Windows.Graphics.Printing

Wichtig

Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.

Bearbeiten

Initiiert programmgesteuert die Benutzeroberfläche für das Drucken von Inhalten.

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)

Gibt zurück

IAsyncOperation<Boolean>

IAsyncOperation<bool>

Ein boolescher Wert, der true für erfolg oder FALSE für einen Fehler angibt.

Attribute: RemoteAsyncAttribute

Hinweise

Diese Methode kann von einer Anwendung verwendet werden, die bereits GetForCurrentView verwendet hat, um die PrintManager-instance abzurufen und einen Listener für das PrintTaskRequested-Ereignis registriert hat, um die Druckbenutzeroberfläche zu initiieren. ShowPrintUIAsync zeigt das entsprechende Druckfenster an. Wenn das Drucken zu diesem Zeitpunkt nicht möglich ist, löst die Methode eine Ausnahme aus. Es wird empfohlen, die Ausnahmen abzufangen und dem Benutzer mitzuteilen, wenn der Druckvorgang nicht fortgesetzt werden kann, wie hier gezeigt.

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

In diesem Beispiel wird ein Druckfenster im Ereignishandler für das Klicken auf eine Schaltfläche angezeigt. Wenn die Methode eine Ausnahme auslöst (da das Drucken zu diesem Zeitpunkt nicht möglich ist), informiert ein ContentDialog-Steuerelement den Benutzer über die Situation. Weitere Informationen zum Drucken aus Ihrer App finden Sie unter Drucken.

Gilt für:

Weitere Informationen

Drucken

Freigeben über