Функция ResetDC


Функция 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
А также поддерживается программой Microsoft Layer for Unicode.

Замечания по платформе

Не имеется

 

Назад в оглавление
На главную страницу
На оглавление справки

Hosted by uCoz