Компонент PrintDialog (Windows Forms)
Компонент PrintDialog Windows Forms является предварительно настроенным диалоговым окном, используемым для выбора принтера и печатаемых страниц, а также для определения других параметров печати в приложениях Windows. Он используется в качестве простого решения для выбора принтера и параметров печати вместо самостоятельной настройки диалогового окна. Пользователям можно предоставить различные варианты печати документов: печать всех страниц, указанного диапазона страниц или выделенного фрагмента текста. Использование стандартных диалоговых окон Windows помогает создавать приложения, основные функциональные возможности которых хорошо знакомы пользователям.
в этом разделе
Общие сведения о компоненте PrintDialog
Основные понятия, связанные с компонентом PrintDialog , который служит для вывода стандартного диалогового окна для выбора принтера и печатаемых страниц, а также для задания параметров печати.
Практическое руководство. Отображение компонента PrintDialog
Инструкции по выводу диалогового окна и заданию расположения для сохранения свойств.
Справочник
PrintDialog
Справочная информация о классе и его членах.
См. также
Элементы управления для использования в Windows Forms
Полный список элементов управления Windows Forms со ссылками на информацию об их применении.
Общие сведения о компоненте PrintDialog (Windows Forms)
Компонент PrintDialog Windows Forms — это предварительно настроенное диалоговое окно, которое используется для выбора принтера и печатаемых страниц, а также для определения других параметров печати в приложениях Windows. Он используется в качестве простого решения для выбора принтера и параметров печати вместо самостоятельной настройки диалогового окна. Пользователям можно предоставить различные варианты печати документов: печать всех страниц, выбранного диапазона страниц или выделенного фрагмента текста. Использование стандартных диалоговых окон Windows помогает создавать приложения, основные функциональные возможности которых хорошо знакомы пользователям. Компонент PrintDialog наследует от класса CommonDialog.
Работа с компонентом
Используйте метод ShowDialog для отображения диалогового окна во время выполнения. Этот компонент имеет свойства, относящиеся либо к одному заданию печати (класс PrintDocument), либо к параметрам отдельного принтера (класс PrinterSettings). Любые из них, в свою очередь, могут совместно использоваться несколькими принтерами.
После добавления в форму компонент PrintDialog отображается на панели задач в нижней части конструктора Windows Forms в Visual Studio.
Print Dialog Класс
Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.
Позволяет пользователям выбирать принтер и определять, какие разделы документа должны быть напечатаны из приложения Windows Forms.
Примеры
В следующем примере кода показано, как использовать PrintDialog элемент управления для задания AllowSomePagesсвойств и Document свойствShowHelp. Чтобы запустить этот пример, вставьте следующий код в форму, содержащую PrintDialog элемент управления с именем и кнопкой с именем Button1«PrintDialog1 . В этом примере требуется, чтобы событие кнопки Click и PrintPage событие docToPrint были подключены к методам обработки событий, определенным в этом примере.
Комментарии
При создании экземпляра PrintDialogсвойства чтения и записи задаются в качестве начальных значений. Список этих значений см. в конструкторе PrintDialog. Чтобы получить параметры принтера, измененные пользователем с PrintDialogпомощью свойства, используйте PrinterSettings свойство.
Дополнительные сведения о печати с помощью Windows Forms см. в обзоре System.Drawing.Printing пространства имен. Если вы хотите распечатать из приложения Windows Presentation Foundation, смSystem.Printing. пространство имен.
Конструкторы
Инициализирует новый экземпляр класса PrintDialog.
Свойства
Получает или задает значение, указывающее, отображается ли переключатель Текущая страница.
Получает или задает значение, указывающее, установлен ли флажок Печать в файл.
Получает или задает значение, определяющее, включен ли переключатель Выбор.
Получает или задает значение, определяющее, включен ли переключатель Страницы.
Возвращает значение, показывающее, может ли компонент вызывать событие.
Возвращает объект IContainer, который содержит коллекцию Component.
Возвращает значение, указывающее, находится ли данный компонент Component в режиме конструктора в настоящее время.
Получает или задает значение, указывающее, какой объект PrintDocument используется для получения PrinterSettings.
Возвращает список обработчиков событий, которые прикреплены к этому объекту Component.
Получает или задает параметры принтера, которые можно изменить в диалоговом окне.
Получает или задает значение, указывающее, установлен ли флажок Печать в файл.
Получает или задает значение, определяющее, отображается ли кнопка Справка.
Получает или задает значение, определяющее, отображается ли кнопка Сеть.
Получает или задает ISite объекта Component.
Получает или задает объект, содержащий данные элемента управления.
Возвращает или задает значение, указывающее, следует ли отображать диалоговое окно в стиле Windows XP для систем, работающих под управлением Windows XP Home Edition, Windows XP Professional, Windows Server 2003 или более поздней версии.
Методы
Создает объект, который содержит всю необходимую информацию для создания прокси-сервера, используемого для взаимодействия с удаленным объектом.
Освобождает все ресурсы, занятые модулем Component.
Освобождает неуправляемые ресурсы, используемые объектом Component, а при необходимости освобождает также управляемые ресурсы.
Определяет, равен ли указанный объект текущему объекту.
Служит хэш-функцией по умолчанию.
Извлекает объект обслуживания во время существования, который управляет политикой времени существования данного экземпляра.
Возвращает объект, представляющий службу, предоставляемую классом Component или классом Container.
Возвращает объект Type для текущего экземпляра.
Определяет процедуру обработки общего диалогового окна, переопределенную, чтобы добавить специальные функции для общего диалогового окна.
Получает объект службы времени существования для управления политикой времени существования для этого экземпляра.
Создает неполную копию текущего объекта Object.
Создает неполную копию текущего объекта MarshalByRefObject.
Определяет процедуру окна-владельца, которая переопределяется, чтобы добавить специальные функции для общего диалогового окна.
Сбрасывает все параметры, принтер, который был выбран последним, и параметры страницы, присваивая значения, использующиеся по умолчанию.
В случае переопределения в производном классе указывает общее диалоговое окно.
Запускает общее диалоговое окно с заданным по умолчанию владельцем.
Запускает общее диалоговое окно с указанным владельцем.
Возвращает объект String, содержащий имя Component, если оно есть. Этот метод не следует переопределять.
События
Возникает при удалении компонента путем вызова метода Dispose().
Происходит при нажатии пользователем кнопки справки в общем диалоговом окне.