Класс CPrintDialogEx

Статья
02/20/2013

Инкапсулирует службы, предоставленные страницей свойств печати в Windows 2000.

class CPrintDialogEx : public CCommonDialog

Члены

Открытые конструкторы

Имя	Описание
CPrintDialogEx::CPrintDialogEx	Создает объект CPrintDialogEx.

Открытые методы

Имя	Описание
CPrintDialogEx::CreatePrinterDC	Создает контекст устройства принтере без отображения диалогового окна печати.
CPrintDialogEx::DoModal	Отображает диалоговое окно и позволяет пользователю выполнить выделения.
CPrintDialogEx::GetCopies	Возвращает запрошенное число копий.
CPrintDialogEx::GetDefaults	Получает устройство по умолчанию без отображения диалогового окна.
CPrintDialogEx::GetDeviceName	Извлекает имя выбранного в данный момент устройства принтера.
CPrintDialogEx::GetDevMode	Извлекает структуру DEVMODE.
CPrintDialogEx::GetDriverName	Извлекает имя система- заданного драйвера устройства принтера.
CPrintDialogEx::GetPortName	Извлекает имя выбранного в данный момент порта принтера.
CPrintDialogEx::GetPrinterDC	Получает дескриптор контекста устройства принтера.
CPrintDialogEx::PrintAll	Указывает, нужно ли выводить все страницы документа.
CPrintDialogEx::PrintCollate	Определяет, является ли разбирается по копиям копии.
CPrintDialogEx::PrintCurrentPage	Определяет, является ли печать текущей страницы документа.
CPrintDialogEx::PrintRange	Указывает, нужно ли выводить только заданный диапазон страниц.
CPrintDialogEx::PrintSelection	Указывает, нужно ли выводить только в данный момент выбранные элементы.

Открытые члены данных

Имя	Описание
CPrintDialogEx::m_pdex	Структура, используемая для настройки объект CPrintDialogEx.

Заметки

Можно положиться на платформе, чтобы обрабатывать многие аспекты процесса печати для приложения.Дополнительные сведения об использовании платформы для обработки задачи печати см. в статье Печать.

Если необходимо приложению обрабатывать печать без вмешательства платформ, то можно использовать класс CPrintDialogEx "как" с использованием предоставленного конструктору или можно создать собственный класс из диалогового окна конструктор CPrintDialogEx и записи в соответствии с свои мере необходимости.В любом случае эти диалоговые окна будут вести себя как стандартные диалоговые окна MFC, поскольку они наследуются от класса CCommonDialog.

Чтобы использовать объект CPrintDialogEx, сначала создайте объект с помощью конструктора CPrintDialogEx.Как только было создано диалоговое окно можно задавать или изменять все значения в структуре m_pdex для инициализации значений элементов управления диалогового окна.Структура m_pdex типа PRINTDLGEX.Дополнительные сведения об этой структуре см. в разделе Windows SDK.

Если не предоставить собственные маркеры для элементов в m_pdexhDevMode и hDevNames, необходимо вызвать функцию Windows GlobalFree для этих маркеров после завершения с диалоговым окном.

После инициализации элементов управления диалогового окна, вызовите функцию-член DoModal для отображения диалогового окна и, чтобы разрешить пользователю выбирать параметры печати.При DoModal возвращает можно указать выбрал ли пользователь применяет ОК или отменить.

Если пользователь отжал кнопку "ОК", то можно использовать функции-члены CPrintDialogEx для получения ввода информации пользователем.

Функция-член CPrintDialogEx::GetDefaults позволяет извлечь текущие значения по умолчанию принтер без отображения диалогового окна.Этот метод не требует взаимодействия с пользователем.

Можно использовать функцию Windows CommDlgExtendedError чтобы определить, произошла ли ошибка во время инициализации диалогового окна и получить дополнительные сведения об ошибке.Дополнительные сведения об этой функции см. в разделе Windows SDK.

Дополнительные сведения об использовании CPrintDialogEx см. в разделе Общие классы диалоговых окон.