PrintManager.ShowPrintUIAsync Metode
Definisi
Penting
Beberapa informasi terkait produk prarilis yang dapat diubah secara signifikan sebelum dirilis. Microsoft tidak memberikan jaminan, tersirat maupun tersurat, sehubungan dengan informasi yang diberikan di sini.
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.