CMFCBaseTabCtrl::SetImageList

  • [アーティクル]

更新 : 2007 年 11 月

タブ コントロールのアイコン イメージ リストを設定します。

virtual BOOL SetImageList(
   UINT uiID,
   int cx = 15,
   COLORREF clrTransp = RGB(255,0,255)
);

virtual BOOL SetImageList(
   HIMAGELIST hImageList 
);

パラメータ

  • [入力] uiID
    ビットマップ リソース ID。SetImageList は、このリソースからイメージ リストを読み込みます。

  • [入力] cx
    各イメージの幅 (ピクセル単位)。

  • [入力] clrTransp
    イメージの透明色を示す COLORREF パラメータ。

  • [入力] hImageList
    プリロードしたイメージ リストのハンドル。

戻り値

メソッドが正常に実行された場合は 0 以外を返します。それ以外の場合は 0 を返します。

解説

アイコン イメージ リストのイメージは、タブのラベルと共に表示されます。アイコンを表示するには、CMFCBaseTabCtrl::AddTab を呼び出すときに、インデックスを指定する必要があります。

タブ コントロールがフラット スタイルで作成されていると、SetImageList は失敗します。uiID で指定されたイメージをフレームワークが読み込むことができない場合も失敗します。

このメソッドは、イメージ サイズとテキスト サイズに従ってタブの高さを再計算します。

必要条件

ヘッダー : afxbasetabctrl.h

参照

概念

MFC 階層図

参照

CMFCBaseTabCtrl クラス