Структура DEVNAMES (commdlg.h)

  • Статья

Содержит строки, определяющие имена драйверов, устройств и выходных портов для принтера. Эти строки должны быть строками ANSI при использовании версии ANSI PrintDlg или PrintDlgEx , а при использовании версии PrintDlg или PrintDlgEx в Юникоде должны быть строками Юникода. Функции PrintDlgEx и PrintDlg используют эти строки для инициализации определяемого системой листа свойств печати или диалогового окна печати. Когда пользователь закрывает страницу свойств или диалоговое окно, сведения о выбранном принтере возвращаются в этой структуре.

Синтаксис

typedef struct tagDEVNAMES {
  WORD wDriverOffset;
  WORD wDeviceOffset;
  WORD wOutputOffset;
  WORD wDefault;
} DEVNAMES;

Члены

wDriverOffset

Тип: WORD

Смещение в символах от начала этой структуры до строки, завершаемой null, которая содержит имя файла (без расширения) драйвера устройства. На входных данных эта строка используется для определения принтера, который будет отображаться изначально в диалоговом окне.

wDeviceOffset

Тип: WORD

Смещение в символах от начала этой структуры до строки, завершающейся нулевым значением, которая содержит имя устройства.

wOutputOffset

Тип: WORD

Смещение (в символах) от начала этой структуры до строки, завершающейся нулевым значением, которая содержит имя устройства для физического выходного носителя (порт вывода).

wDefault

Тип: WORD

Указывает, идентифицируют ли строки, содержащиеся в структуре DEVNAMES , принтер по умолчанию. Эта строка используется для проверки того, что принтер по умолчанию не изменился с момента последней операции печати. Если какая-либо из строк не совпадает, отображается предупреждающее сообщение, информирующее пользователя о необходимости переформатировать документ. В выходных данных элемент wDefault изменяется только в том случае, если было отображено диалоговое окно Настройка печати и пользователь нажал кнопку ОК . Флаг DN_DEFAULTPRN используется, если выбран принтер по умолчанию. Если выбран определенный принтер, флаг не используется. Все остальные флаги в этом элементе зарезервированы для внутреннего использования процедурой диалогового окна для страницы свойств печать или диалогового окна Печать .

Требования

Требование Значение
Минимальная версия клиента Windows 2000 Professional [только классические приложения]
Минимальная версия сервера Windows 2000 Server [только классические приложения]
Верхняя часть commdlg.h (включая Windows.h)

См. также раздел

Общая библиотека диалоговых окон

Основные понятия

PrintDlg

PrintDlgEx

Справочные материалы