PrintDialog Класс

Определение

Вызывает стандартное диалоговое окно печати Microsoft Windows, которое настраивает объекты PrintTicket и PrintQueue в соответствии с введенными данными, а затем распечатывает документ.Invokes a standard Microsoft Windows print dialog box that configures a PrintTicket and PrintQueue according to user input and then prints a document.

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

Примеры

В следующем примере показано, как создать экземпляр и отобразить простой PrintDialog с помощью Язык XAMLExtensible Application Markup Language (XAML) разметки и кода.The following example shows how to create an instance of and display a simple PrintDialog by using Язык XAMLExtensible Application Markup Language (XAML) markup and code.

<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

Комментарии

Пользователь может использовать диалоговое окно Печать , чтобы выбрать принтер, настроить его и выполнить задание печати.A user can use the Print dialog box to select a printer, configure it, and perform a print job.

Строго говоря, PrintDocument метод можно использовать без открытия диалогового окна.Strictly speaking, you can use the PrintDocument method without ever opening the dialog. В этом смысле элемент управления можно использовать как незамеченный компонент печати.In that sense, the control can be used as an unseen printing component. Но по соображениям AddJob производительности лучше использовать либо метод, либо один из множества Write методов XpsDocumentWriterи WriteAsync .But for performance reasons, it would be better to use either the AddJob method or one of the many Write and WriteAsync methods of the XpsDocumentWriter. Дополнительные сведения см. в разделе как Печать XPS-файловпрограммными средствами.For more about this, see How to: Programmatically Print XPS Files.

Не путайте этот класс System.Windows.Controls.PrintDialogс. System.Windows.Forms.PrintDialogDo not confuse this class, System.Windows.Controls.PrintDialog, with System.Windows.Forms.PrintDialog. Последний используется с Windows Forms приложениями.The latter is used with Windows Forms applications. System.Windows.Controls.PrintDialogиспользуется с приложениями Windows Presentation Foundation.System.Windows.Controls.PrintDialog is used with Windows Presentation Foundation applications.

Конструкторы

PrintDialog()

Инициализирует новый экземпляр класса PrintDialog.Initializes a new instance of the PrintDialog class.

Свойства

CurrentPageEnabled

Получает или задает значение, указывающее, включена ли функция печати текущей страницы.Gets or sets a value that indicates whether the option to print the current page is enabled.

MaxPage

Возвращает или задает наибольший номер страницы, допустимый в диапазоне страниц.Gets or sets the highest page number that is allowed in page ranges.

MinPage

Возвращает или задает наименьший номер страницы, допустимый в диапазоне страниц.Gets or sets the lowest page number that is allowed in page ranges.

PageRange

Возвращает или задает печатаемый диапазон страниц, когда свойство PageRangeSelection получает значение UserPages.Gets or sets the range of pages to print when PageRangeSelection is set to UserPages.

PageRangeSelection

Возвращает или задает свойство PageRangeSelection данного экземпляра класса PrintDialog.Gets or sets the PageRangeSelection for this instance of PrintDialog.

PrintableAreaHeight

Возвращает высоту печатаемой области страницы.Gets the height of the printable area of the page.

PrintableAreaWidth

Возвращает ширину печатаемой области страницы.Gets the width of the printable area of the page.

PrintQueue

Возвращает или задает очередь PrintQueue, представляющую выбранный принтер.Gets or sets a PrintQueue that represents the printer that is selected.

PrintTicket

Возвращает или задает объект PrintTicket, который используется объектом PrintDialog, когда пользователь нажимает кнопку Печать, чтобы выполнить текущее задание печати.Gets or sets the PrintTicket that is used by the PrintDialog when the user clicks Print for the current print job.

SelectedPagesEnabled

Получает или задает значение, указывающее, включена ли функция печати выбранных страниц.Gets or sets a value that indicates whether the option to print the selected pages is enabled.

UserPageRangeEnabled

Возвращает или задает значение, показывающее, могут ли пользователи диалогового окна Печать определять диапазон печатаемых страниц.Gets or sets a value that indicates whether users of the Print dialog box have the option to specify ranges of pages to print.

Методы

Equals(Object)

Определяет, равен ли указанный объект текущему объекту.Determines whether the specified object is equal to the current object.

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

Служит в качестве хэш-функции по умолчанию.Serves as the default hash function.

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

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

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

Создает неполную копию текущего объекта Object.Creates a shallow copy of the current Object.

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

Печатает объект DocumentPaginator в очереди PrintQueue, выбранной на данный момент.Prints a DocumentPaginator object to the PrintQueue that is currently selected.

PrintVisual(Visual, String)

Печатает визуальный (нетекстовый) объект, производный из класса Visual, в очереди PrintQueue, выбранной на данный момент.Prints a visual (non-text) object, which is derived from the Visual class, to the PrintQueue that is currently selected.

ShowDialog()

Вызывает PrintDialog в качестве модального диалогового окна.Invokes the PrintDialog as a modal dialog box.

ToString()

Возвращает строку, представляющую текущий объект.Returns a string that represents the current object.

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

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