ListView_MapIndexToID マクロ (commctrl.h)

項目のインデックスを一意の ID にマップします。このマクロを使用することも、LVM_MAPINDEXTOID メッセージを明示的に送信することもできます。

構文

UINT ListView_MapIndexToID(
   HWND hwnd,
   UINT index
);

hwnd

型: HWND

リストビューコントロールのハンドル。

index

型: UINT

項目のインデックスを含む UINT。

型: UINT

一意の ID を返します。

リストビューコントロールは、インデックスによって項目を内部的に追跡します。これにより、コントロールの存在中にインデックスが変更される可能性があるため、問題が発生する可能性があります。

このマクロを使用すると、アイテムの作成時に ID を持つ項目にタグを付けることができます。この ID は、リストビューコントロールの存在中に一意性を保証するために使用します。

項目を一意に識別するには、IComponent::GetDisplayInfo などの呼び出しから返されるインデックスを取得し、LVM_MAPINDEXTOIDを呼び出します。戻り値は一意の ID です。

注マルチスレッド環境では、バックグラウンドスレッドではなく、リストビューコントロールをホストするスレッドでのみ正しいインデックスが返されることを確認できます。

ListView_MapIndexToIDを使用するには、マニフェスト Comctl32.dll バージョン 6 を指定します。マニフェストの詳細については、「Visual Stylesを有効にする」を参照してください。