Fungsi RestoreDC (wingdi.h)

Fungsi RestoreDC memulihkan konteks perangkat (DC) ke status yang ditentukan. DC dipulihkan dengan memunculkan informasi status dari tumpukan yang dibuat oleh panggilan sebelumnya ke fungsi SaveDC .

Sintaks

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

Parameter

[in] hdc

Handel ke DC.

[in] nSavedDC

Status tersimpan yang akan dipulihkan. Jika parameter ini positif, nSavedDC mewakili instans tertentu dari status yang akan dipulihkan. Jika parameter ini negatif, nSavedDC mewakili instans yang relatif terhadap status saat ini. Misalnya, -1 memulihkan status yang terakhir disimpan.

Menampilkan nilai

Jika fungsi berhasil, nilai yang dikembalikan bukan nol.

Jika fungsi gagal, nilai yang dikembalikan adalah nol.

Keterangan

Setiap DC mempertahankan tumpukan status tersimpan. Fungsi SaveDC mendorong status DC saat ini ke tumpukan status tersimpannya. Status itu hanya dapat dipulihkan ke DC yang sama dari mana ia dibuat. Setelah status dipulihkan, status tersimpan dihancurkan dan tidak dapat digunakan kembali. Selain itu, status apa pun yang disimpan setelah status yang dipulihkan dibuat juga dihancurkan dan tidak dapat digunakan. Dengan kata lain, fungsi RestoreDC memunculkan status yang dipulihkan (dan status berikutnya) dari tumpukan informasi status.

Persyaratan

Lihat juga

Fungsi Konteks Perangkat

Gambaran Umum Konteks Perangkat

SaveDC