CWnd::LockWindowUpdate

指定されたウィンドウへの描画を禁止します。

BOOL LockWindowUpdate( );

戻り値

関数が正常終了したときは 0 以外を返します。 エラーが発生した場合や、LockWindowUpdate 関数を使ってほかのウィンドウがロックされている場合は 0 を返します。

解説

ロックされたウィンドウを移動することはできません。 一度に 1 つのウィンドウしかロックできません。 LockWindowUpdate でロックしたウィンドウのロックを解除するには、UnlockWindowUpdate を呼び出します。

ロックされたウィンドウ (または、ロックされた子ウィンドウ) のあるアプリケーションによって GetDCGetDCEx、または BeginPaint のいずれかの Windows 関数が呼び出されると、呼び出された関数によって、可視領域が空のデバイス コンテキストが返されます。 この状態は、アプリケーションが UnlockWindowUpdate メンバー関数を使ってウィンドウのロックを解除するまで続きます。

ウィンドウの更新がロックされている間は、ロックされたウィンドウに割り当てられたデバイス コンテキストへの描画操作の外接する四角形がシステムによってトレースされます。 描画が再許可されると、この外接する四角形はロックされているウィンドウおよびその子ウィンドウで無効になり、画面を更新するために強制的に WM_PAINT メッセージを送信します。 ウィンドウの更新がロックされている間に描画操作が発生しなかった場合は、領域は無効にされません。

LockWindowUpdate メンバー関数は、指定されたウィンドウを不可視にすることも、WS_VISIBLE スタイル ビットをクリアすることもありません。

必要条件

**ヘッダー:**afxwin.h

参照

参照

CWnd クラス

階層図

CWnd::GetDCEx

LockWindowUpdate

概念

CWnd のメンバー