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