CImageList::FromHandle

2011-08-09

イメージリストへのハンドルを指定すると、CImageList オブジェクトへのポインターを返します。

static CImageList* PASCAL FromHandle(
   HIMAGELIST hImageList 
);

パラメーター

hImageList
イメージリストへのハンドル。

戻り値

正常終了した場合は、CImageList オブジェクトへのポインターを返します。それ以外の場合は NULL を返します。

解説

CImageList オブジェクトがまだハンドルに結び付けられていない場合は、一時的な CImageList オブジェクトが作成され、ハンドルに結び付けられます。この一時的な CImageList オブジェクトは、次にアプリケーションがイベントループでアイドル状態になるまで有効です。アプリケーションがアイドル状態になると、すべての一時的なオブジェクトが削除されます。

使用例

CImageList* ConvertHandle(HIMAGELIST hmyImageList)
{
   // Convert the HIMAGELIST to a CImageList*.
   ASSERT(hmyImageList != NULL);
   CImageList* pmyImageList = CImageList::FromHandle(hmyImageList);
   ASSERT(pmyImageList != NULL);

   return pmyImageList;
}