RestoreDC 関数 (wingdi.h)

RestoreDC 関数は、デバイス コンテキスト (DC) を指定された状態に復元します。 DC は、 SaveDC 関数の以前の呼び出しによって作成されたスタックから状態情報をポップすることによって復元されます。

構文

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

パラメーター

[in] hdc

DC へのハンドル。

[in] nSavedDC

復元する保存済みの状態。 このパラメーターが正の場合、 nSavedDC は復元する状態の特定のインスタンスを表します。 このパラメーターが負の場合、 nSavedDC は現在の状態を基準としたインスタンスを表します。 たとえば、-1 は最後に保存された状態を復元します。

戻り値

関数が成功すると、戻り値は 0 以外になります。

関数が失敗した場合は、0 を返します。

解説

各 DC は、保存された状態のスタックを保持します。 SaveDC 関数は、DC の現在の状態を保存された状態のスタックにプッシュします。 その状態は、その状態が作成されたのと同じ DC にのみ復元できます。 状態が復元されると、保存された状態は破棄され、再利用できません。 さらに、復元された状態が作成された後に保存された状態も破棄され、使用できません。 言い換えると、 RestoreDC 関数は、復元された状態 (およびそれ以降の状態) を状態情報スタックからポップします。

要件

関連項目

デバイス コンテキスト関数

デバイス コンテキストの概要

SaveDC