次の方法で共有


CImageList::Create

更新 : 2007 年 11 月

イメージ リストを初期化し、CImageList オブジェクトに結び付けます。

BOOL Create(
   int cx,
   int cy,
   UINT nFlags,
   int nInitial,
   int nGrow 
);
BOOL Create(
   UINT nBitmapID,
   int cx,
   int nGrow,
   COLORREF crMask 
);
BOOL Create(
   LPCTSTR lpszBitmapID,
   int cx,
   int nGrow,
   COLORREF crMask 
);
BOOL Create(
   CImageList& imagelist1,
   int nImage1,
   CImageList& imagelist2,
   int nImage2,
   int dx,
   int dy 
);
BOOL Create(
   CImageList* pImageList 
);

パラメータ

  • cx
    ピクセル単位の各イメージのサイズ。

  • cy
    ピクセル単位の各イメージのサイズ。

  • nFlags
    作成するイメージ リストの種類を指定します。このパラメータは以下の値を組み合わせて指定できます。ただし、ILC_COLOR 値は 1 つに限られます。

    説明

    ILC_COLOR

    ほかの ILC_COLOR* フラグを何も指定しないと、既定の処理が行われます。通常、ILC_COLOR4 が既定値です。ただし、旧ディスプレイ ドライバの既定値は ILC_COLORDDB です。

    ILC_COLOR4

    イメージ リストのビットマップとして、4 ビット (16 色) のデバイスに依存しないビットマップ (DIB) セクションが使われます。

    ILC_COLOR8

    8 ビットの DIB セクションが使われます。カラー テーブルに使用する色はハーフトーン パレットと同じ色です。

    ILC_COLOR16

    16 ビット (3,2000/6,4000 色) の DIB セクションが使われます。

    ILC_COLOR24

    24 ビットの DIB セクションが使われます。

    ILC_COLOR32

    32 ビットの DIB セクションが使われます。

    ILC_COLORDDB

    デバイスに依存しないビットマップが使われます。

    ILC_MASK

    マスクを使用します。イメージ リストの 2 つのビットマップのうち、一方のモノクロ ビットマップはマスクに使われます。この値を取り込まないと、イメージ リストのビットマップが 1 つだけになります。

  • nInitial
    イメージ リストが最初に保持しているイメージの数。

  • nGrow
    システムが新しいイメージを格納するためにリストのサイズを変更する必要があるとき、イメージ リストを拡張できるイメージ数。このパラメータは、サイズ変更されたイメージ リストが持つことができる新しいイメージの数を表します。

  • nBitmapID
    イメージ リストに関連付けられたビットマップのリソース ID。

  • crMask
    マスクを生成するために使う色。指定されたビットマップでこの色を持つ各ピクセルは黒色に変更され、マスク内の対応するビットは 1 に設定されます。

  • lpszBitmapID
    イメージのリソース ID を持つ文字列。

  • imagelist1
    CImageList オブジェクトへの参照。

  • nImage1
    存在するイメージの先頭イメージのインデックス。

  • imagelist2
    CImageList オブジェクトへの参照。

  • nImage2
    存在するイメージの 2 番目のイメージのインデックス。

  • dx
    先頭イメージと 2 番目のイメージの x 軸方向のピクセル単位の相対オフセット値。

  • dy
    先頭イメージと 2 番目のイメージの y 軸方向のピクセル単位の相対オフセット値。

  • pImageList
    CImageList オブジェクトへのポインタ。

戻り値

正常終了した場合は 0 以外を返します。それ以外の場合は 0 を返します。

解説

CImageList は 2 ステップで構築します。まず、コンストラクタを呼び出し、その後 Create を呼び出してイメージ リストを作成し、CImageList オブジェクトに結び付けます。

使用例

m_myImageList.Create(32, 32, ILC_COLOR8, 0, 4);

必要条件

ヘッダー : afxcmn.h

参照

参照

CImageList クラス

階層図

CImageList::CImageList

COLORREF

その他の技術情報

CImageList のメンバ