PrintDialog Класс

Определение

Пространство имен:

System.Windows.Controls

Сборка:

PresentationFramework.dll

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

public ref class PrintDialog

public class PrintDialog

type PrintDialog = class

Public Class PrintDialog

Наследование

Object

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.Value)
    {
        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)