CWnd::OnSizeClipboard

クリップボードが CF_OWNERDISPLAY 属性でデータを持ち、クリップボード ビューアー ウィンドウのクライアント領域のサイズが変更されたとき、クリップボード ビューアーからクリップボード オーナーの OnSizeClipboard メンバー関数が呼び出されます。

afx_msg void OnSizeClipboard(
   CWnd* pClipAppWnd,
   HGLOBAL hRect 
);

パラメーター

  • pClipAppWnd
    クリップボード アプリケーションのウィンドウを識別します。 このポインターは一時的である場合があるので、後で使用するために保持しておくことはできません。

  • hRect
    グローバル メモリ オブジェクトを識別します。 メモリ オブジェクトには、クリップボード オーナーが描画する領域を指定した RECT データ構造体が含まれます。

解説

クリップボード アプリケーションが破棄または最小化される直前に、新しいサイズに null 四角形 (0,0,0,0) を指定して OnSizeClipboard メンバー関数が呼び出されます。 これにより、クリップボード オーナーはディスプレイのリソースを解放できます。

アプリケーションは、OnSizeClipboard 関数内で GlobalLock Windows 関数を使用して、RECT データ構造体を持つメモリをロックする必要があります。 アプリケーションは、制御を譲渡したり、戻したりする前に、GlobalUnlock Windows 関数を使用して、そのメモリのロックを解除する必要があります。

注意

このメンバー関数は、アプリケーションが Windows メッセージを処理できるようにするためにフレームワークによって呼び出されます。 この関数に渡されるパラメーターの値は、フレームワークがメッセージ受信時に受け取ったパラメーターの値に基づいています。 この関数の基本クラスの実装を呼び出した場合は、関数に渡したパラメーターではなく、メッセージと共に渡されたパラメーター自体が使用されます。

必要条件

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

参照

参照

CWnd クラス

階層図

GlobalLock

GlobalUnlock

SetClipboardData

CWnd::SetClipboardViewer

WM_SIZECLIPBOARD

概念

CWnd のメンバー