Функция RestoreDC

Функция RestoreDC восстанавливает контекст устройства (DC) в заданное состояние. Контекст устройства (DC) восстанавливается, путем удаления информации о состоянии из стека, созданного ранее при вызове функции SaveDC.

Синтаксис

BOOL RestoreDC(
  HDC hdc,       // дескриптор контекста устройства (DC)
  int nSavedDC   // режим восстановления
);

Параметры

hdc

[in] Дескриптор контекста устройства (DC).

nSavedDC

[in] Устанавливает сохраненное состояние, которое будет восстановлено. Если этот параметр положительный, nSavedDC обозначает конкретный экземпляр состояния, которое будет восстановлено. Если этот параметр - отрицательное значение, nSavedDC обозначает экземпляр относительно текущего состояния. Например, - (минус)1 восстанавливает самое последнее сохраненное состояние.

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

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

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

Windows NT/2000/XP: Чтобы получить дополнительные сведения об ошибке, вызовите GetLastError.

Замечания

Стек может содержать информацию о состоянии для нескольких экземпляров контекста устройства (DC). Если состояние, определяемое заданным параметром - не наверху стека, функция RestoreDC удаляет всю информацию о состоянии между вершиной стека и до заданного экземпляра.

Смотри также

Размещение и совместимость RestoreDC
Windows. NET Server	Да
Windows XP	Да
Windows 2000	Да
Windows NT	Да версии 3.1 и выше
Windows Me	Да
Windows 98	Да
Windows 95	Да
Используемая библиотека	Gdi32.lib
Заголовочный файл
- объявлено в	Wingdi.h
- включено в	Windows.h
Unicode	Нет
Замечания по платформе	Не имеется