COMPAREITEMSTRUCT 構造体 (winuser.h)

  • [アーティクル]

並べ替えられた所有者描画リスト ボックスまたはコンボ ボックス内の 2 つのアイテムの識別子とアプリケーション指定のデータを提供します。

アプリケーションが、 CBS_SORTまたはLBS_SORT スタイルで作成された所有者描画リスト ボックスまたはコンボ ボックスに新しい項目 を 追加するたびに、システムは所有者に WM_COMPAREITEM メッセージを送信します。 メッセージの lParam パラメーターには、 COMPAREITEMSTRUCT 構造体への長いポインターが含まれています。 メッセージを受信すると、所有者は 2 つのアイテムを比較し、他方の項目の前に並べ替えを示す値を返します。

構文

typedef struct tagCOMPAREITEMSTRUCT {
  UINT      CtlType;
  UINT      CtlID;
  HWND      hwndItem;
  UINT      itemID1;
  ULONG_PTR itemData1;
  UINT      itemID2;
  ULONG_PTR itemData2;
  DWORD     dwLocaleId;
} COMPAREITEMSTRUCT, *PCOMPAREITEMSTRUCT, *LPCOMPAREITEMSTRUCT;

メンバー

CtlType

型: UINT

ODT_LISTBOX (所有者が描画したリスト ボックス) またはODT_COMBOBOX (所有者が描画したコンボ ボックス)。

CtlID

型: UINT

リスト ボックスまたはコンボ ボックスの識別子。

hwndItem

種類: HWND

コントロールへのハンドル。

itemID1

型: UINT

比較対象のリスト ボックスまたはコンボ ボックスの最初の項目のインデックス。 アイテムが挿入されていない場合、またはリスト ボックスまたはコンボ ボックスで潜在的なアイテムを検索する場合、このメンバーは –1 になります。

itemData1

種類: ULONG_PTR

比較対象の最初の項目のアプリケーション提供データ。 (この値は、リスト ボックスまたはコンボ ボックスに項目を追加したメッセージの lParam パラメーターとして渡されました。

itemID2

型: UINT

比較対象のリスト ボックスまたはコンボ ボックス内の 2 番目の項目のインデックス。

itemData2

種類: ULONG_PTR

比較対象の 2 番目の項目のアプリケーション提供データ。 この値は、リスト ボックスまたはコンボ ボックスに項目を追加したメッセージの lParam パラメーターとして渡されました。 アイテムが挿入されていない場合、またはリスト ボックスまたはコンボ ボックスで潜在的なアイテムを検索する場合、このメンバーは –1 になります。

dwLocaleId

種類: DWORD

ロケール識別子です。 ロケール識別子を作成するには、 MAKELCID マクロを使用します。

要件

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

こちらもご覧ください

コンボ ボックス

概念

MAKELCID

その他のリソース

リファレンス

WM_COMPAREITEM