Функция ResetDC обновляет заданный контекст устройства принтера или графопостроителя, используя заданную информацию.
Синтаксис
HDC ResetDC( HDC hdc, // дескриптор контекста устройства (DC) CONST DEVMODE *lpInitData // информация о DC ); |
Параметры
hdc
[in] Дескриптор контекста устройства (DC), который модифицируется.lpInitData
[in] Указатель на структуру DEVMODE, содержащую информацию о новом контексте устройства (DC).Возвращаемые значения
Если функция завершается успешно, возвращаемое значение - дескриптор первоначального контекста устройства (DC).
Если функция завершается ошибкой, возвращаемое значение - ПУСТО (NULL).
Windows NT/2000/XP: Чтобы получить дополнительные сведения об ошибке, вызовите GetLastError.
Замечания
Приложение должно обычно использовать функцию ResetDC тогда, когда окно получает сообщение WM_DEVMODECHANGE. ResetDC может также использоваться для изменения ориентации бумаги или магазина бумагоподающего устройства при печати документа.
Функция ResetDC не может использоваться для изменение имени драйвера, имени устройства или порта вывода данных. Когда пользователь изменяет порт подключения или имя устройства, приложение должно удалить первоначальный контекст устройства (DC) и создать новый контекст устройства с новой информацией.
Приложение может передать информационный контекст устройства в функцию ResetDC. В этой ситуации ResetDC будет всегда возвращать значение контекста устройства (DC) принтера.
ICM: Совокупность параметров соответствия цветов контекста устройства , определяемого параметром hdc должна быть сброшена на основании информации, содержавшей в члене lpInitData структуры DEVMODE.
Windows 95/98/Me: ResetDCW поддерживается программой Microsoft Layer for Unicode. Чтобы использовать ее, Вы должны добавить некоторые файлы к вашему приложению, как изложено в описании Microsoft Layer for Unicode для системы Windows 95/98/Me.
Смотри также
Обзор Контексты устройства, Функции, используемые контекстами устройства, DeviceCapabilities, DEVMODE, Escape
Размещение и совместимость ResetDC |
|
Windows. NET Server |
Да |
Windows XP |
Да |
Windows 2000 |
Да |
Windows NT |
Да версии 3.1 и выше |
Windows Me |
Да |
Windows 98 |
Да |
Windows 95 |
Да |
Используемая библиотека |
Gdi32.lib |
Заголовочный файл |
|
- объявлено в |
Wingdi.h |
- включено в |
Windows.h |
Unicode |
Реализуется как версии Unicode
и ANSI для Windows 2000/XP. |
Замечания по платформе |
Не имеется |