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