BCM_SETIMAGELIST メッセージ

ボタン コントロールにイメージ リストを割り当てます。 このメッセージは明示的に送信することも、 Button_SetImageList マクロを使用することもできます。

パラメーター

wParam

使用されません。は 0 である必要があります。

lParam

イメージ リスト情報を含む BUTTON_IMAGELIST 構造体へのポインター。

戻り値

メッセージが成功すると、 TRUE が返されます。 それ以外の場合は FALSE を返します。

注釈

注意

このメッセージを使用するには、バージョン 6.0 Comclt32.dll指定するマニフェストを指定する必要があります。 マニフェストの詳細については、「 ビジュアル スタイルの有効化」を参照してください。

BUTTON_IMAGELIST構造体の himl メンバーで参照されるイメージ リストには、すべての状態に使用する 1 つのイメージまたは各状態の個々のイメージが含まれている必要があります。 vssym32.h では、次の状態が定義されています。

enum PUSHBUTTONSTATES {
    PBS_NORMAL = 1,
    PBS_HOT = 2,
    PBS_PRESSED = 3,
    PBS_DISABLED = 4,
    PBS_DEFAULTED = 5,
    PBS_STYLUSHOT = 6,
};

PBS_STYLUSHOTはタブレット コンピューターでのみ使用されることに注意してください。

各値は、イメージ リスト内の適切なイメージへのインデックスです。 イメージが 1 つだけ存在する場合は、すべての状態に使用されます。 画像リストに複数の画像が含まれている場合、各インデックスはボタンの 1 つの状態に対応します。 状態ごとにイメージが指定されていない場合、イメージのない状態に対しては何も描画されません。

要件

要件	値
サポートされている最小のクライアント	Windows Vista [デスクトップ アプリのみ]
サポートされている最小のサーバー	Windows Server 2003 [デスクトップ アプリのみ]
Header	Commctrl.h