Bagikan melalui


PrintManager.ShowPrintUIAsync Metode

Definisi

Secara terprogram memulai antarmuka pengguna untuk mencetak konten.

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)

Mengembalikan

Nilai Boolean untuk menunjukkan TRUE untuk keberhasilan atau FALSE untuk kegagalan.

Atribut

Keterangan

Metode ini dapat digunakan oleh aplikasi yang telah menggunakan GetForCurrentView untuk mengambil instans PrintManager dan telah mendaftarkan pendengar untuk peristiwa PrintTaskRequested untuk memulai pengalaman pengguna pencetakan. ShowPrintUIAsync menampilkan jendela pencetakan yang sesuai. Jika pencetakan tidak dapat dilakukan pada saat itu, metode akan memberikan pengecualian. Sebaiknya tangkap pengecualian ini dan beri tahu pengguna saat pencetakan tidak dapat dilanjutkan, seperti yang ditunjukkan di sini.

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

Dalam contoh ini, jendela cetak ditampilkan di penanganan aktivitas untuk klik tombol. Jika metode melemparkan pengecualian (karena pencetakan tidak dapat dilakukan pada saat itu), kontrol ContentDialog memberi tahu pengguna tentang situasi tersebut. Untuk informasi selengkapnya tentang pencetakan dari aplikasi Anda, lihat Mencetak.

Berlaku untuk

Lihat juga