PrintDialog 類別

定義

命名空間:

System.Windows.Controls

組件:

PresentationFramework.dll

叫用根據使用者輸入設定 PrintTicket 和 PrintQueue 的標準 Microsoft Windows 列印對話方塊，然後列印文件。

C#

public class PrintDialog

繼承

Object

PrintDialog

範例

下列範例示範如何使用 Extensible Application Markup Language (XAML) 標記和程式碼，建立 實例並顯示簡單 PrintDialog 。

XAML

<Button Width="200" Click="InvokePrint">Invoke PrintDialog</Button>

...

C#

private void InvokePrint(object sender, RoutedEventArgs e)
{
    // Create the print dialog object and set options
    PrintDialog pDialog = new PrintDialog();
    pDialog.PageRangeSelection = PageRangeSelection.AllPages;
    pDialog.UserPageRangeEnabled = true;

    // Display the dialog. This returns true if the user presses the Print button.
    Nullable<Boolean> print = pDialog.ShowDialog();
    if (print.Value)
    {
        XpsDocument xpsDocument = new XpsDocument("C:\\FixedDocumentSequence.xps", FileAccess.ReadWrite);
        FixedDocumentSequence fixedDocSeq = xpsDocument.GetFixedDocumentSequence();
        pDialog.PrintDocument(fixedDocSeq.DocumentPaginator, "Test print job");
    }
}

備註

使用者可以使用 [ 列印 ] 對話方塊來選取印表機、設定印表機，以及執行列印工作。

嚴格來說，您可以使用 PrintDocument 方法，而不需要開啟對話方塊。 如此一來，控制項就可以當做看不到的列印元件使用。 但基於效能考慮，最好是使用 AddJob 方法或 其中 Write 一個 和 WriteAsync 方法 XpsDocumentWriter 。 如需詳細資訊，請參閱 如何：以程式設計方式列印 XPS 檔案。

請勿將這個類別 System.Windows.Controls.PrintDialog 與 System.Windows.Forms.PrintDialog 混淆。 後者會與Windows Forms應用程式搭配使用。 System.Windows.Controls.PrintDialog會與Windows Presentation Foundation應用程式搭配使用。

建構函式

PrintDialog()

初始化 PrintDialog 類別的新執行個體。

屬性

CurrentPageEnabled	取得或設定值，指出列印目前頁面的選項是否已啟用。
MaxPage	取得或設定頁面範圍所允許之最大頁碼。
MinPage	取得或設定頁面範圍所允許之最小頁碼。
PageRange	取得或設定當 PageRangeSelection 設為 UserPages 時要列印的頁面範圍。
PageRangeSelection	取得或設定這個 PageRangeSelection 執行個體的 PrintDialog。
PrintableAreaHeight	取得頁面可列印區域高度。
PrintableAreaWidth	取得頁面可列印區域寬度。
PrintQueue	取得或設定表示所選取之印表機的 PrintQueue。
PrintTicket	取得或設定當使用者為目前列印工作按下 [列印] 時，PrintDialog 使用的 PrintTicket。
SelectedPagesEnabled	取得或設定值，這個值表示列印所選頁面的選項是否已啟用。
UserPageRangeEnabled	取得或設定值，這個值表示 [列印] 對話方塊使用者是否可使用選項指定要列印之頁面範圍。

方法

PrintDocument(DocumentPaginator, String)	列印 DocumentPaginator 物件至目前選取的 PrintQueue。
PrintVisual(Visual, String)	將從 Visual 類別衍生而來的視覺 (非文字) 物件列印到目前選取的 PrintQueue。
ShowDialog()	叫用 PrintDialog 作為強制回應對話方塊。

適用於