共用方式為

RestoreDC 函式 (wingdi.h)

  • 發行項

RestoreDC函式會將裝置內容還原 (DC) 至指定的狀態。 DC 會藉由從先前呼叫 SaveDC 函式所建立的堆疊中取出狀態資訊來還原。

語法

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

參數

[in] hdc

DC 的控制碼。

[in] nSavedDC

要還原的已儲存狀態。 如果此參數為正數， nSavedDC 代表要還原的狀態特定實例。 如果此參數為負數， nSavedDC 代表相對於目前狀態的實例。 例如，-1 會還原最近儲存的狀態。

傳回值

如果函式成功，則傳回非零的值。

如果此函式失敗，則傳回值為零。

備註

每個 DC 都會維護儲存狀態的堆疊。 SaveDC函式會將 DC 的目前狀態推送至其已儲存狀態的堆疊。 該狀態只能還原至建立該狀態的相同 DC。 還原狀態之後，會終結儲存的狀態，而且無法重複使用。 此外，建立還原狀態之後儲存的任何狀態也會遭到終結，而且無法使用。 換句話說， RestoreDC 函式會從狀態資訊堆疊) 快顯還原狀態 (和任何後續狀態。

規格需求

   
最低支援的用戶端 Windows 2000 專業版 [僅限傳統型應用程式]
最低支援的伺服器 Windows 2000 Server [僅限傳統型應用程式]
目標平台 Windows
標頭 wingdi.h (包含 Windows.h)
程式庫 Gdi32.lib
Dll Gdi32.dll

另請參閱

裝置內容函式

裝置內容概觀

SaveDC