Compartilhar via


Função RestoreDC (wingdi.h)

A função RestoreDC restaura um DC (contexto de dispositivo) para o estado especificado. O DC é restaurado tirando informações de estado de uma pilha criada por chamadas anteriores para a função SaveDC .

Sintaxe

BOOL RestoreDC(
  [in] HDC hdc,
  [in] int nSavedDC
);

Parâmetros

[in] hdc

Um identificador para o DC.

[in] nSavedDC

O estado salvo a ser restaurado. Se esse parâmetro for positivo, nSavedDC representará uma instância específica do estado a ser restaurada. Se esse parâmetro for negativo, nSavedDC representará uma instância relativa ao estado atual. Por exemplo, -1 restaura o estado salvo mais recentemente.

Valor retornado

Se a função for bem-sucedida, o valor retornado será diferente de zero.

Se a função falhar, o valor retornado será zero.

Comentários

Cada DC mantém uma pilha de estados salvos. A função SaveDC envia por push o estado atual do DC para sua pilha de estados salvos. Esse estado só pode ser restaurado para o mesmo DC do qual foi criado. Depois que um estado é restaurado, o estado salvo é destruído e não pode ser reutilizado. Além disso, todos os estados salvos após a criação do estado restaurado também são destruídos e não podem ser usados. Em outras palavras, a função RestoreDC exibe o estado restaurado (e quaisquer estados subsequentes) da pilha de informações de estado.

Requisitos

   
Cliente mínimo com suporte Windows 2000 Professional [somente aplicativos da área de trabalho]
Servidor mínimo com suporte Windows 2000 Server [somente aplicativos da área de trabalho]
Plataforma de Destino Windows
Cabeçalho wingdi.h (inclua Windows.h)
Biblioteca Gdi32.lib
DLL Gdi32.dll

Confira também

Funções de contexto do dispositivo

Visão geral dos contextos do dispositivo

Savedc