Поделиться через


PrintDialog Класс

Определение

Вызывает стандартное диалоговое окно печати Microsoft Windows, которое настраивает объекты PrintTicket и PrintQueue в соответствии с введенными данными, а затем распечатывает документ.

public ref class PrintDialog
public class PrintDialog
type PrintDialog = class
Public Class PrintDialog
Наследование
PrintDialog

Примеры

В следующем примере показано, как создать экземпляр и отобразить простой PrintDialog объект с помощью разметки и кода XAML.

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

...

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 == true)
        {
            XpsDocument xpsDocument = new XpsDocument("C:\\FixedDocumentSequence.xps", FileAccess.ReadWrite);
            FixedDocumentSequence fixedDocSeq = xpsDocument.GetFixedDocumentSequence();
            pDialog.PrintDocument(fixedDocSeq.DocumentPaginator, "Test print job");
        }
    }
Private Sub InvokePrint(ByVal sender As Object, ByVal e As RoutedEventArgs)
        ' Create the print dialog object and set options
        Dim pDialog As New PrintDialog()
        pDialog.PageRangeSelection = PageRangeSelection.AllPages
        pDialog.UserPageRangeEnabled = True

        ' Display the dialog. This returns true if the user presses the Print button.
        Dim print? As Boolean = pDialog.ShowDialog()
        If print = True Then
            Dim xpsDocument As New XpsDocument("C:\FixedDocumentSequence.xps", FileAccess.ReadWrite)
            Dim fixedDocSeq As FixedDocumentSequence = xpsDocument.GetFixedDocumentSequence()
            pDialog.PrintDocument(fixedDocSeq.DocumentPaginator, "Test print job")
        End If
End Sub

Комментарии

Пользователь может использовать диалоговое окно Печать , чтобы выбрать принтер, настроить его и выполнить задание печати.

Строго говоря, можно использовать метод PrintDocument без открытия диалогового окна. В этом смысле элемент управления можно использовать как невидимый компонент печати. Однако по соображениям производительности было бы лучше использовать метод AddJob или один из многих методов Write и WriteAsync в XpsDocumentWriter. Дополнительные сведения см. в разделе Практическое руководство. Программная печать XPS-файлов.

Не путайте этот класс с System.Windows.Controls.PrintDialogSystem.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

Возвращает или задает объект PrintTicket, который используется объектом PrintDialog, когда пользователь нажимает кнопку Печать, чтобы выполнить текущее задание печати.

SelectedPagesEnabled

Получает или задает значение, указывающее, включена ли функция печати выбранных страниц.

UserPageRangeEnabled

Возвращает или задает значение, показывающее, могут ли пользователи диалогового окна Печать определять диапазон печатаемых страниц.

Методы

Equals(Object)

Определяет, равен ли указанный объект текущему объекту.

(Унаследовано от Object)
GetHashCode()

Служит хэш-функцией по умолчанию.

(Унаследовано от Object)
GetType()

Возвращает объект Type для текущего экземпляра.

(Унаследовано от Object)
MemberwiseClone()

Создает неполную копию текущего объекта Object.

(Унаследовано от Object)
PrintDocument(DocumentPaginator, String)

Печатает объект DocumentPaginator в очереди PrintQueue, выбранной на данный момент.

PrintVisual(Visual, String)

Печатает визуальный (нетекстовый) объект, производный из класса Visual, в очереди PrintQueue, выбранной на данный момент.

ShowDialog()

Вызывает PrintDialog в качестве модального диалогового окна.

ToString()

Возвращает строку, представляющую текущий объект.

(Унаследовано от Object)

Применяется к