CPen::FromHandle
更新 : 2007 年 11 月
指定された Windows の GDI ペン オブジェクトへのハンドルに対応する CPen オブジェクトへのポインタを返します。
static CPen* PASCAL FromHandle(
HPEN hPen
);
パラメータ
- hPen
Windows の GDI のペンへの HPEN ハンドルを指定します。
戻り値
正常終了した場合は、CPen オブジェクトへのポインタを返します。それ以外の場合は NULL を返します。
解説
CPen オブジェクトがハンドルに結び付けられていない場合は、一時的な CPen オブジェクトが生成され結び付けられます。この一時的な CPen オブジェクトは、次にアプリケーションがイベント ループでアイドル状態になるまで有効です。アイドル状態になったとき、一時的なグラフィック オブジェクトはすべて削除されます。つまり、一時的なオブジェクトは、1 つのウィンドウ メッセージの処理中のみ有効になります。
使用例
// Convert an HPEN to a CPen*.
// NOTE: hPen is a valid pen handle.
CPen* pPen = CPen::FromHandle(hPen);
必要条件
ヘッダー : afxwin.h