CDC::RestoreDC

[アーティクル]
08/09/2011

デバイスコンテキストを nSavedDC で識別される直前の状態に復元します。

virtual BOOL RestoreDC(
   int nSavedDC 
);

パラメーター

nSavedDC
復元するデバイスコンテキストを指定します。直前に SaveDC 関数を呼び出したときに返された値を指定できます。 nSavedDC が -1 のときは、最後に保存されたデバイスコンテキストに復元されます。

戻り値

指定したコンテキストが復元された場合は 0 以外を返します。それ以外の場合は 0 を返します。

解説

RestoreDC 関数は、それより前に SaveDC メンバー関数の呼び出しによって作成されたスタックに保存した状態情報を取り出すことでデバイスコンテキストを復元します。

スタックには、複数のデバイスコンテキストの状態情報を保存できます。パラメーター nSavedDC で指定されたコンテキストがスタックの一番上にない場合、RestoreDC 関数は nSavedDC で指定されたデバイスコンテキストとスタックの一番上の間にあるすべての状態情報を削除します。削除された情報は失われます。