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

Статья
11/20/2024

Функция сброса 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 hdc, будет сброшен на основе сведений, содержащихся в lpInitData член структуры DEVMODE.

Заметка

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

Требования

Требование	Ценность
минимальные поддерживаемые клиентские	Windows 2000 Профессиональный [только классические приложения]
минимальный поддерживаемый сервер	Windows 2000 Server [только классические приложения]
целевая платформа	Виндоус
заголовка	wingdi.h (включая Windows.h)
библиотеки	Gdi32.lib
DLL	Gdi32.dll

См. также

DEVMODE

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

Обзор контекстов устройств

DeviceCapabilities

escape-

Поделиться через