PrintManager.ShowPrintUIAsync Methode
Definition
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.
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
Ein boolescher Wert, der true für erfolg oder FALSE für einen Fehler angibt.
- Attribute
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.