Функция ResetDCA (wingdi.h)

  • Статья

Функция ResetDC обновляет указанный контекст устройства принтера или плоттера (DC), используя указанные сведения.

Синтаксис

HDC ResetDCA(
  [in] HDC            hdc,
  [in] const DEVMODEA *lpdm
);

Параметры

[in] hdc

Дескриптор контроллера домена для обновления.

[in] lpdm

Указатель на структуру DEVMODE, содержащую сведения о новом контроллере домена.

Возвращаемое значение

Если функция выполняется успешно, возвращаемое значение является дескриптором для исходного контроллера домена.

Если функция завершается сбоем, возвращается значение NULL.

Комментарии

Обычно приложение использует функцию ResetDC , когда окно получает сообщение WM_DEVMODECHANGE . ResetDC также можно использовать для изменения ориентации бумаги или бумажных контейнеров во время печати документа.

Функция ResetDC не может использоваться для изменения имени драйвера, имени устройства или порта вывода. Когда пользователь изменяет подключение к порту или имя устройства, приложение должно удалить исходный контроллер домена и создать новый контроллер домена с новыми сведениями.

Приложение может передавать сведения контроллера домена функции ResetDC . В этом случае ResetDC всегда будет возвращать принтер контроллера домена.

ICM: Цветовый профиль контроллера домена, заданный параметром hdc, сбрасывается на основе сведений, содержащихся в элементе lpInitData структуры DEVMODE .

Примечание

Заголовок wingdi.h определяет ResetDC как псевдоним, который автоматически выбирает версию ANSI или Юникод этой функции на основе определения константы препроцессора UNICODE. Сочетание использования псевдонима, не зависящий от кодировки, с кодом, не зависящим от кодировки, может привести к несоответствиям, которые приводят к ошибкам компиляции или среды выполнения. Дополнительные сведения см. в разделе Соглашения для прототипов функций.

Требования

Требование Значение
Минимальная версия клиента Windows 2000 Professional [только классические приложения]
Минимальная версия сервера Windows 2000 Server [только классические приложения]
Целевая платформа Windows
Header wingdi.h (включая Windows.h)
Библиотека Gdi32.lib
DLL Gdi32.dll

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

DEVMODE

Функции контекста устройства

Общие сведения о контекстах устройств

DeviceCapabilities

ESCAPE