IResultData

IResultData インターフェイスを使用すると、結果ビューペインに関連付けられた項目の追加、削除、検索、変更を行えます。また、結果ビューペインのビュースタイルを操作することもできます。

IResultData::InsertItem メソッドを使用すると、スナップインは結果ペインビューに 1 つの新しい項目を追加できます。

このメソッドは、これらの値のいずれかを返すことがあります。

RESULTDATAITEM 構造体の mask と、関連するすべての適切なフィールドを設定する必要があります。サブ項目は挿入できませんが、設定は可能です。したがって、item 構造体の nCol メンバーは 0 でなければなりません。

RESULTDATAITEM の str メンバーは MMC_CALLBACK に設定する必要があります。

項目が挿入されると、MMC によって一意の識別子 (項目 ID) が割り当てられ、item パラメーターが指す構造体の itemID メンバーを通じて返されます。itemID の値は、挿入された項目の HRESULTITEM ハンドルであることに注意してください。スナップインは、後で IResultData::GetItem などのメソッドを呼び出して挿入した項目を操作できるように、この値を保存しておく必要があります。

この識別子を保存していない場合は、 IResultData::FindItemByLParam を使用して特定できます。

このメソッドは仮想リストをサポートしていません。

スナップインが結果ビューペイン内の単一の項目を削除できるようにします。

このメソッドは、これらの値のいずれかを返すことがあります。

DeleteItem は、itemID と nCol で識別される項目を削除します。nCol が 0 でない場合、itemID と nCol で識別されるサブ項目のすべての情報がクリアされます。nCol が 0 の場合、itemID で識別される項目とそのすべてのサブ項目が削除され、リストから取り除かれます。サブ項目が削除された場合、itemID は有効な識別子のまま残ります。ただし、メイン項目が削除された場合は、itemID を破棄または解放する必要があります。同じ ID は、コンソールによって新しく挿入された項目に再割り当てされることがあります。

IResultData::FindItemByLParam メソッドを使用すると、スナップインはユーザーが挿入した lParam の値に基づいて項目またはサブ項目を検索できます。

このメソッドは、これらの値のいずれかを返すことがあります。

FindItemByLParam は、lParam に基づいて項目を検索します。lParam が一致するリスト内の最初の項目の一意の識別子 (cookie) が pItemID に返されます。項目が見つからない場合、この検索は S_FALSE を返します。

このメソッドは仮想リストをサポートしていません。

IResultData::DeleteAllRsltItems メソッドを使用すると、スナップインはユーザーが挿入したすべての項目とサブ項目を結果ビューペインから削除できます。

このメソッドは、これらの値のいずれかを返すことがあります。

このメソッドは、結果ビューペインと仮想リストの両方に対して同じ機能を提供します。

IResultData::SetItem メソッドを使用すると、スナップインは結果ペイン内の単一の項目を設定できます。

このメソッドは、これらの値のいずれかを返すことがあります。

item パラメーターが指す構造体の itemID メンバーは、リスト内で変更する項目またはサブ項目を参照するように設定する必要があります。RESULTDATAITEM 構造体の mask と、関連するすべての適切なフィールドに、変更したい内容を設定する必要があります。nCol メンバーは 0 に設定する必要があります。これは、何かを設定または取得できる唯一の列であるためです。RESULTDATAITEM の str メンバーは、常に MMC_CALLBACK に設定する必要があります。

このメソッドは仮想リストをサポートしていません。

ユーザーが単一の項目のパラメーターを取得できるようにします。

このメソッドは、これらの値のいずれかを返すことがあります。

item パラメーターが指す RESULTDATAITEM 構造体の itemID メンバーは、情報を返す対象の項目またはサブ項目を参照するように設定する必要があります。nCol メンバーは 0 に設定する必要があります。これは、何かを取得または設定できる唯一の列であるためです。さらに、このメソッド呼び出しが成功した場合、item パラメーターが指す構造体の mask メンバーに設定された各フラグに対応するデータメンバーが返されます。

itemID が 0 の場合は、nIndex メンバーを使用できます。

仮想リストに適用する場合は、nIndex メンバーを使用し、itemID を 0 に設定する必要があります。仮想リストでは、項目の選択状態とフォーカス状態のみを取得できます。

IResultData::GetNextItem メソッドは、指定した状態フラグが設定されている結果ビュー内の次の項目を取得します。

このメソッドは、これらの値のいずれかを返すことがあります。

仮想リストに適用する場合、指定できる状態フラグは LVIS_FOCUSED と LVIS_SELECTED のみです。lParam メンバーは常に 0 に設定されます。

スナップインが項目の状態を変更できるようにします。

このメソッドは、これらの値のいずれかを返すことがあります。

IResultData::ModifyViewStyle メソッドを使用すると、スナップインは結果ペインのビュースタイルを設定できます。

このメソッドは、これらの値のいずれかを返すことがあります。

このメソッドは、結果ビューペインと仮想リストの両方に対して同じ機能を提供します。

スナップインが、結果ビューペインで項目を表示するビューモードを設定できるようにします。

このメソッドは、これらの値のいずれかを返すことがあります。

このメソッドは、仮想リストビューと非仮想リストビューの両方に対して同じ機能を提供します。IResultData::SetViewMode を使用できるシナリオの詳細については、 リストビューの使用: 実装の詳細 を参照してください。

スナップインが結果ビューペインのビューモードを取得できるようにします。

このメソッドは、これらの値のいずれかを返すことがあります。

このメソッドは、仮想リストビューと非仮想リストビューの両方に対して同じ機能を提供します。

結果ペイン内の指定した項目を再描画させます。

このメソッドは、これらの値のいずれかを返すことがあります。

UpdateItem は通常、ユーザーが項目に変更を加えた後に、表示されている項目を更新するために使用されます。

結果ペイン内のすべての項目を並べ替えます。

このメソッドは、これらの値のいずれかを返すことがあります。

スナップインが IResultDataCompare または IResultDataCompareEx インターフェイスを実装している場合、MMC はそのインターフェイスの Compare メソッドを呼び出して、スナップインがリスト項目を比較できるようにします。それ以外の場合、MMC は既定の文字列比較関数を使用します。

仮想リストには並べ替え機能がありません。仮想リストの並べ替えを可能にするには、スナップインが IResultOwnerData インターフェイスを実装する必要があります。IResultData::Sort が呼び出されると、MMC はその呼び出しを IResultOwnerData::SortItems に転送します。

結果ビューペインの説明バーのテキストを設定します。

このメソッドは、これらの値のいずれかを返すことがあります。

このメソッドは、結果ビューペインと仮想リストの両方に対して同じ機能を提供します。

仮想リスト内の項目数を設定します。

このメソッドは、これらの値のいずれかを返すことがあります。

SetItemCount メソッドの主な目的は、仮想リストにデータを設定 (populate) することです。仮想リストには実際に項目が追加されないため、これは仮想項目がいくつ存在するかをリストに通知する方法です。

MMCLV_UPDATE_NOINVALIDATEALL フラグは、仮想リストの末尾でのみ追加や削除を行い、再描画の量を減らしたい場合に使用します。このフラグを設定すると、MMC は結果ペインに追加された新しい項目に対してのみ IComponent::GetDisplayInfo を呼び出します。このフラグを設定すると、いずれの項目も番号の振り直しが行われないことが MMC に伝わります。MMC は、追加または削除された表示中の項目のみを再描画します。

SetItemCount は非仮想リストに対しても呼び出せますが、目的は異なります。非仮想リストに対して呼び出された場合、 SetItemCount は指定した数の項目分のメモリを事前に割り当てます。多数の項目を追加する場合、これによってリストが行う必要のあるメモリ割り当て呼び出しの回数が減り、パフォーマンスが向上します。

#define global IID_IResultData "{31DA5FA0-E0EB-11CF-9F21-00AA003CA9F6}"
#usecom global IResultData IID_IResultData "{}"
#comfunc global IResultData_InsertItem          3 var
#comfunc global IResultData_DeleteItem          4 sptr,int
#comfunc global IResultData_FindItemByLParam    5 sptr,var
#comfunc global IResultData_DeleteAllRsltItems  6
#comfunc global IResultData_SetItem             7 var
#comfunc global IResultData_GetItem             8 var
#comfunc global IResultData_GetNextItem         9 var
#comfunc global IResultData_ModifyItemState     10 int,sptr,int,int
#comfunc global IResultData_ModifyViewStyle     11 int,int
#comfunc global IResultData_SetViewMode         12 int
#comfunc global IResultData_GetViewMode         13 var
#comfunc global IResultData_UpdateItem          14 sptr
#comfunc global IResultData_Sort                15 int,int,sptr
#comfunc global IResultData_SetDescBarText      16 wstr
#comfunc global IResultData_SetItemCount        17 int,int
; ※数字は vtbl インデックス(0始まり)。0/1/2 は IUnknown(QueryInterface/AddRef/Release)。
; ※このインターフェースは直接 CoCreateInstance するクラスIDが無いため "{}"(他メソッド/アクティベーションで取得)。
; ※出力/バッファ引数は var(変数直渡し)。varptr 方式にも切替可。
; ※ハンドル/void*等の不透明ポインタは IronHSP では intptr 指定が可能。