Share via

ListView_SetCallbackMask マクロ (commctrl.h)

  • [アーティクル]

リスト ビュー コントロールのコールバック マスクを変更します。 このマクロを使用することも、 LVM_SETCALLBACKMASK メッセージを明示的に送信することもできます。

構文

void ListView_SetCallbackMask(
   hwnd,
   mask
);

パラメーター

hwnd

種類: HWND

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

mask

型: UINT

コールバック マスクの値。 マスクのビットは、アプリケーションが現在の状態データを格納するアイテムの状態またはイメージを示します。 この値には、次の定数を任意に組み合わせて使用できます。

値 意味
LVIS_CUT
 項目は、切り取りと貼り付けの操作でマークされます。
LVIS_DROPHILITED
 項目はドラッグ アンド ドロップ ターゲットとして強調表示されます。
LVIS_FOCUSED
 項目にフォーカスがあります。
LVIS_SELECTED
 項目が選択されています。
LVIS_OVERLAYMASK
 アプリケーションは、各項目の現在のオーバーレイ イメージのイメージ リスト インデックスを格納します。
LVIS_STATEIMAGEMASK
 アプリケーションは、アイテムごとに現在の状態イメージのイメージ リスト インデックスを格納します。

戻り値

なし

解説

リスト ビュー コントロールの コールバック マスク は、コントロールではなくアプリケーションが現在のデータを格納する項目の状態を指定する一連のビット フラグです。 コールバック項目の指定が個別の項目に適用されるのに対し、コールバック マスクは、コントロールのすべての項目に適用されます。 既定では、コールバック マスクは 0 です。つまり、リスト ビュー コントロールにはすべての項目の状態情報が格納されます。 リスト ビュー コントロールを作成してその項目を初期化したら、 ListView_SetCallbackMask マクロまたは LVM_SETCALLBACKMASK メッセージを使用してコールバック マスクを変更できます。 現在のコールバック マスクを取得するには、 LVM_GETCALLBACKMASK メッセージを送信します。

オーバーレイ イメージと状態イメージの詳細については、「List-View Image Lists」を参照してください。

リスト ビューコールバックの詳細については、「コールバック項目とコールバック マスク」を参照してください。

要件

要件 値
サポートされている最小のクライアント Windows Vista [デスクトップ アプリのみ]
サポートされている最小のサーバー Windows Server 2003 (デスクトップ アプリのみ)
対象プラットフォーム Windows
ヘッダー commctrl.h

こちらもご覧ください

LVN_GETDISPINFO