RESULTDATAITEM 構造体 (mmc.h)

[アーティクル]
08/24/2023

RESULTDATAITEM 構造体は、スナップインの結果ウィンドウで結果項目の属性を指定または受信します。

構文

typedef struct _RESULTDATAITEM {
  DWORD       mask;
  BOOL        bScopeItem;
  HRESULTITEM itemID;
  int         nIndex;
  int         nCol;
  LPOLESTR    str;
  int         nImage;
  UINT        nState;
  LPARAM      lParam;
  int         iIndent;
} RESULTDATAITEM;

メンバー

mask

このデータ構造の属性を指定するフラグのセット、またはこの構造体を使用する操作。

次のフラグは、有効なデータを含む RESULTDATAITEM 構造体のメンバーを指定します。または、データを入力する必要があります。 1 つ以上のフラグを設定できます。

RDI_STR (0x0002)

str メンバーが有効であるか、入力する必要があります。

RDI_IMAGE (0x0004)

nImage メンバーが有効であるか、入力する必要があります。

RDI_STATE (0x0008)

nState メンバーは有効であるか、入力する必要があります。

RDI_PARAM (0x0010)

lParam メンバーは有効であるか、入力する必要があります。

RDI_INDEX (0x0020)

nIndex メンバーは有効であるか、入力する必要があります。

RDI_INDENT (0x0040)

iIndent メンバーは有効であるか、入力する必要があります。

bScopeItem

lParam メンバーがスコープ項目を参照している場合は TRUE。 LParam メンバーが結果アイテムを参照している場合は FALSE。

itemID

結果アイテムのコンソール指定の一意の項目識別子を指定する値。この値は、一部のユーザーに対する呼び出しの結果ウィンドウ内の項目を識別するために使用されます。
IResultData インターフェイスメソッド。

スナップインが (IResultData::InsertItem を使用して) スコープウィンドウに項目を正常に挿入した後、RESULTDATAITEM 構造体の itemID メンバーには、新しく挿入されたアイテムの HRESULTITEM ハンドルが含まれます。このハンドルは、結果アイテムの一意識別子です。

スナップインは、 IResultData::GetItem などのメソッドを呼び出して、挿入された項目を操作 (後で) するためにこの値を格納する必要があります。この値が格納されていない場合は、 IResultData::FindItemByLParam を使用して検索できます。

nIndex

この構造体が参照する項目の 0 から始まるインデックスを示す値。

nCol

操作を実行する列を指定する値。列ではなく項目に対して操作を実行する場合、値は 0 (0) になります。

str

構造体で RDI_STR 項目属性が指定されている場合に、アイテムテキストを含む null で終わる文字列へのポインター。このメンバーが MMC_CALLBACK 値の場合、項目はコールバック項目です。

スナップインでは、MMC_CALLBACKの代わりに MMC_TEXTCALLBACK を使用できることに注意 してください。 MMC_TEXTCALLBACK値は、型が正しい (キャストする必要がない) バージョンのMMC_CALLBACKです。

MMC_TEXTCALLBACK は MMC バージョン 1.2 で導入されています。

nImage

大小のアイコン画像リスト内のリストビュー項目のアイコンの仮想イメージインデックス。仮想イメージインデックスは、内部的に実際のインデックスにマップされていることに注意してください。このメンバーは、コールバックアイテムとして指定することもできます: MMC_CALLBACK または MMC_IMAGECALLBACK。 MMC_IMAGECALLBACK値は、型が正しい (キャストする必要がない) バージョンのMMC_CALLBACKです。

MMC_IMAGECALLBACK は MMC バージョン 1.2 で導入されています。

nState

アイテムの状態マスクを指定する値。次のいずれかの値を指定できます。

LVIS_CUT

この項目は、切り取りと貼り付けの操作でマークされます。

LVIS_DROPHILITED

項目はドラッグアンドドロップターゲットとして強調表示されます。

LVIS_FOCUSED

項目にはフォーカスがあるため、標準のフォーカス四角形で囲まれます。複数の項目を選択できますが、フォーカスできる項目は 1 つだけです。

LVIS_SELECTED

項目が選択されています。選択した項目の外観は、フォーカスがあるかどうか、および選択に使用されるシステムカラーによって異なります。

メモLVIS_* 定数を使用するには、ソースファイルに CommCtrl.h を含めます。

lParam

項目に関連付けるユーザー指定の 32 ビット値を指定する値。 Cookie とも呼ばれるこの項目は、 IComponent::QueryDataObject に最初のパラメーターとして渡される値です。

iIndent

予約済み。

必要条件

要件	値
サポートされている最小のクライアント	Windows Vista
サポートされている最小のサーバー	Windows Server 2008
Header	mmc.h

こちらもご覧ください

IResultData

Share via