Función RestoreDC

La función RestoreDC recupera el estado de un contexto de dispositivo (DC). El DC es restaurado extrayendo la información de estado desde la pila creada anteriormente mediante llamadas a la función SaveDC.

BOOL RestoreDC(
  HDC hdc,
  int nSavedDC
);

Parámetros

hdc

Un manipuladr del DC.

nSavedDC

El estado guardado a recuperar. Si éste parámetro es positivo, nSavedDC representa una instancia específica del estado a restaurar. Si éste parámetro es negativo, nSavedDC representa una instancia relativa al estado actual. Por ejemplo, -1 restaura el estado más recientemente guardado.

Valor de retorno

Si la función tiene éxito, el valor retornado es distinto de cero.

Si la función falla, el valor de retorno es cero.

Observaciones

Cada DC mantiene una pila de estados guardados. La función SaveDC apila el estado actual del DC en la pila de estados guardados. Ese estado puede ser restaurado solo al mismo DC a partir de cual fue creado. Después de que un estado es restaurado, el estado guardado es destruido y no puede ser usado de nuevo. Además, cualquiera de los estados guardados después del estado restaurado también será destruido y tampoco podrá ser usado. En otras palabras, la función RestoreDC recupera de la pila el estado restaurado, y cualquier estado posterior.