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.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.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

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

SelectedPagesEnabled

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

UserPageRangeEnabled

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

Методы

Имя Описание
Equals(Object)

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

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

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

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

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

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

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

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

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

PrintVisual(Visual, String)

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

ShowDialog()

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

ToString()

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

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

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