TB_SETPRESSEDIMAGELIST メッセージ

[アーティクル]
05/12/2022

ツールバーが押された状態のボタンを表示するために使用する画像の一覧を設定します。

パラメーター

wParam: イメージリストのインデックス。イメージリストを 1 つだけ使用する場合は、このパラメーターを 0 に設定します。複数の画像リストの使用の詳細については、「解説」を参照してください。
lParam: 設定するイメージリストを処理します。このパラメーターが NULL の場合、ボタンにはイメージは表示されません。

戻り値

押された状態のボタンを表示するために以前に使用したイメージリストのハンドルを返します。そのような画像リストが以前に設定されていない場合は NULL を 返します。

解説

Note

アプリケーションは、ツールバーが破棄された後にイメージリストを解放する役割を担います。

TB_SETPRESSEDIMAGELIST メッセージをTB_ADDBITMAPと組み合わせることはできません。また、内部的にTB_ADDBITMAP呼び出す CreateToolbarEx で作成されたツールバーでは使用できません。 CreateToolbarEx を使用してツールバーを作成するか、TB_ADDBITMAPを使用してイメージを追加すると、ツールバーはイメージリストを内部的に管理します。 TB_SETPRESSEDIMAGELISTで変更しようとすると、予測できない結果になります。

ボタンイメージは、同じ画像リストから取得する必要はありません。ツールバーボタンの画像に複数の画像リストを使用するには:

wParam (バージョン番号) が 5 に設定されたCCM_SETVERSION メッセージをツールバーコントロールに送信して、複数のイメージリストを有効にします。
使用する画像リストごとに、ツールバーコントロールに TB_SETPRESSEDIMAGELIST メッセージを送信します。リストの識別に使用するアプリケーション定義の wParam 値に wParam を設定します。リストの HIMAGELIST ハンドルに lParam を設定します。
各ボタンについて、ボタンの TBBUTTON 構造体の iBitmap メンバーを MAKELONG(iIndex, iImageID) に設定します。 iImageID 値は、手順 2 で定義された適切なイメージリストの ID です。 iIndex 値は、そのリスト内の特定のイメージのインデックスです。
ツールバーコントロールにTB_ADDBUTTONS メッセージを送信して、ボタンを追加します。

次のコードフラグメントは、3 つの異なる画像リストの画像を含む 5 つのボタンをツールバーに追加する方法を示しています。 CCM_SETVERSION メッセージでは、複数のイメージリストのサポートが有効になります。その後、イメージリストが設定され、0 から 2 の ID が割り当てられます。ボタンには、次のようにイメージリストからイメージが割り当てられます。

ボタン 0 は、インデックスが 1 の画像リスト 0 (ahim[0]) の値です。
ボタン 1 は、インデックスが 1 の画像リスト 1 (ahim[1]) から取得したものです。
ボタン 2 は、インデックスが 1 の画像リスト 2 (ahim[2]) から取得したものです。
ボタン 3 は、インデックスが 2 の画像リスト 0 (ahim[0]) の値です。
ボタン 4 は、インデックスが 3 の画像リスト 1 (ahim[1]) から取得したものです。

最後に、ボタンがツールバーコントロールに追加され、 TB_ADDBUTTONS メッセージが表示されます。

// Enable multiple image lists
    SendMessage(hwndTB, CCM_SETVERSION, (WPARAM) 5, 0); 

    //Set the image lists and assign them IDs of 0-2
    SendMessage(hwndTB, TB_SETPRESSEDIMAGELIST, 0, (LPARAM)ahiml[0]);
    SendMessage(hwndTB, TB_SETPRESSEDIMAGELIST, 1, (LPARAM)ahiml[1]);
    SendMessage(hwndTB, TB_SETPRESSEDIMAGELIST, 2, (LPARAM)ahiml[2]);

    // Create the five buttons
    TBBUTTON rgtb[5];
    
    //... initialize the TBBUTTON structures as usual ...
    
    //Assign images to each button
    rgtb[0].iBitmap = MAKELONG(1, 0);
    rgtb[1].iBitmap = MAKELONG(1, 1);
    rgtb[2].iBitmap = MAKELONG(1, 2);
    rgtb[3].iBitmap = MAKELONG(2, 0);
    rgtb[4].iBitmap = MAKELONG(3, 1);

    // Add the five buttons to the toolbar control
    SendMessage(hwndTB, TB_ADDBUTTONS, 5, (LPARAM)(&rgtb);

要件

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

TB_SETPRESSEDIMAGELIST メッセージ

パラメーター

戻り値

解説

要件

関連項目