PrintManager.ShowPrintUIAsync 메서드

정의

프로그래밍 방식으로 콘텐츠 인쇄를 위한 사용자 인터페이스를 시작합니다.

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)

반환

성공에 대한 TRUE 또는 실패에 대한 FALSE를 나타내는 부울 값입니다.

특성

설명

이 메서드는 이미 GetForCurrentView를 사용하여 PrintManager instance 검색하고 PrintTaskRequested 이벤트에 대한 수신기를 등록하여 인쇄 사용자 환경을 시작한 애플리케이션에서 사용할 수 있습니다. ShowPrintUIAsync 는 적절한 인쇄 창을 표시합니다. 이때 인쇄를 수행할 수 없는 경우 메서드는 예외를 throw합니다. 다음과 같이 이러한 예외를 catch하고 인쇄를 진행할 수 없는 경우 사용자에게 알리는 것이 좋습니다.

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

이 예제에서는 단추 클릭에 대한 이벤트 처리기에 인쇄 창이 표시됩니다. 당시에 인쇄를 수행할 수 없기 때문에 메서드가 예외를 throw한 경우 ContentDialog 컨트롤은 사용자에게 상황을 알려 줍니다. 앱에서 인쇄하는 방법에 대한 자세한 내용은 인쇄를 참조하세요.

적용 대상

추가 정보