PrintManager.ShowPrintUIAsync Metodo
Definizione
Importante
Alcune informazioni sono relative alla release non definitiva del prodotto, che potrebbe subire modifiche significative prima della release definitiva. Microsoft non riconosce alcuna garanzia, espressa o implicita, in merito alle informazioni qui fornite.
Avvia a livello di codice l'interfaccia utente per la stampa del contenuto.
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)Restituisce
Valore booleano per indicare un valore TRUE per l'esito positivo o false per un errore.
- Attributi
Commenti
Questo metodo può essere usato da un'applicazione che ha già usato GetForCurrentView per recuperare l'istanza di PrintManager e ha registrato un listener per l'evento PrintTaskRequested per avviare l'esperienza utente di stampa. ShowPrintUIAsync visualizza la finestra di stampa appropriata. Se non è possibile eseguire la stampa in quel momento, il metodo genererà un'eccezione. È consigliabile rilevare queste eccezioni e consentire all'utente di sapere quando la stampa non può continuare, come illustrato di seguito.
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 questo esempio viene visualizzata una finestra di stampa nel gestore di eventi per un clic su un pulsante. Se il metodo genera un’eccezione (perché non è possibile eseguire la stampa in quel momento), un controllo ContentDialog informa l’utente della situazione. Per altre info sulla stampa dalla tua app, vedi Stampa.