PrintManager.ShowPrintUIAsync Metodo

Riferimento

Definizione

Spazio dei nomi:: Windows.Graphics.Printing

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.

Modifica

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

IAsyncOperation<Boolean>

IAsyncOperation<bool>

Valore booleano per indicare un valore TRUE per l'esito positivo o false per un errore.

Attributi: RemoteAsyncAttribute

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.

Si applica a

Vedi anche

Stampa

Condividi tramite