Win32 API 日本語リファレンス
ホーム › UI.Shell › IShellDetails

IShellDetails

COM
📘 Microsoft Learn (日本語) · English
IID000214ec-0000-0000-c000-000000000046継承元IUnknown自前メソッド開始 vtbl3

公式ドキュメント

Shell フォルダーによって公開され、フォルダー内の項目に関する詳細情報を提供します。

解説(Remarks)

Windows 2000 以降のシステムでは、フォルダーオブジェクトはこのインターフェイスの代わりに IShellFolder2 を実装する必要があります。ただし、アプリケーションがそれ以前のシステムで動作する必要がある場合は、IShellDetails も併せて公開する必要があります。

メソッド 2

vtbl = vtable インデックス(0始まり)。HSP等からCOMメソッドをインデックス指定で呼ぶ際に使用します。0〜2 は IUnknown。

vtbl 3 HRESULT GetDetailsOf(ITEMIDLIST* pidl, DWORD iColumn, SHELLDETAILS* pDetails)

Shell フォルダー内の項目に関する詳細情報を取得します。

pidlITEMIDLIST*inoptional情報を要求する項目の PIDL。このパラメーターが NULL に設定されている場合、iColumn で指定された情報フィールドのタイトルが、pDetails が指す SHELLDETAILS 構造体に返されます。
iColumnDWORDin目的の情報フィールドの 0 から始まるインデックス。これは、Windows エクスプローラーの詳細ビューで表示される情報の列番号と同一です。
pDetailsSHELLDETAILS*out詳細情報を格納する SHELLDETAILS 構造体へのポインター。

戻り値

型: HRESULT

成功した場合は S_OK を返します。iColumn がフォルダーでサポートされている列数を超える場合は E_FAIL を返します。それ以外の場合は、標準の COM エラーコードを返します。

解説(Remarks)

このメソッドは、Shell の バージョン 5.0 以降では IShellFolder2 のメソッドに置き換えられています。

IShellDetails::GetDetailsOf メソッドは、Shell フォルダーの Windows エクスプローラー詳細ビューに表示される情報へのアクセスを提供します。詳細ビューに表示される列番号、列タイトル、および項目情報は、IShellDetails::GetDetailsOf が返すものと同一です。

利用可能な情報フィールドとその列番号は、フォルダーごとに異なります。利用可能なフィールドを列挙するには、pidl を NULL に設定し、iColumn の値を増やしながら IShellDetails::GetDetailsOf を呼び出します。この方法により、各列インデックスに関連付けられたタイトルを取得できます。iColumn がフォルダーでサポートされている列数を超えると、IShellDetails::GetDetailsOf は E_FAIL を返します。これらのタイトルはローカライズ可能であり、すべてのロケールで同じであるとは限らない点に注意してください。

ファイルシステムフォルダーには、大きな標準の情報フィールドセットがあります。最初の 4 つのフィールドは、すべてのファイルシステムフォルダーで標準です。

列インデックス 列タイトル
0 名前
1 サイズ
2 種類
3 更新日時

ファイルシステムフォルダーは、多数の追加フィールドをサポートする場合があります。ただし、それが必須というわけではなく、これらのフィールドに割り当てられる列インデックスは変わる可能性があります。

各仮想フォルダーには、独自の情報フィールドセットがあります。通常、項目の表示名は列 0 にありますが、利用可能なフィールドの順序と内容は、特定のフォルダーオブジェクトの実装に依存します。

実装者への注意

フォルダーオブジェクトは、このインターフェイスの代わりに IShellFolder2 を実装する必要があります。
vtbl 4 HRESULT ColumnClick(DWORD iColumn)

列を並べ替えます。

iColumnDWORDin並べ替える列のインデックス。

戻り値

型: HRESULT

選択された列を並べ替えるように呼び出し元アプリケーションに指示するには S_FALSE を返します。それ以外の場合、成功したときは S_OK を、失敗したときは COM エラーコードを返します。

解説(Remarks)

このメソッドは、フォルダーオブジェクトのクライアントが、詳細列の 1 つの内容に基づいてオブジェクトの項目を並べ替えたい場合に呼び出されます。フォルダーオブジェクトは通常 S_FALSE を返します。

実装者への注意

Windows 2000 以降のシステムでは、フォルダーオブジェクトはこのインターフェイスの代わりに IShellFolder2 を実装する必要があります。ただし、アプリケーションがそれ以前のシステムで動作する必要がある場合は、IShellDetails も併せて公開する必要があります。
出典・ライセンス: 上記「公式ドキュメント」の内容は Microsoft の Win32 API ドキュメント(MicrosoftDocs/sdk-api)を日本語に翻訳・改変したものです。© Microsoft Corporation. CC BY 4.0 で提供。
Microsoft 公式リファレンス: 英語 (en-us) · 日本語 (ja-jp) · 原文ソース (GitHub)

HSP用 COM定義

#usecom / #comfunc によるHSPのCOM呼び出し定義。数字は vtbl インデックス(0始まり)。クラスIDが無い場合 #usecom の末尾は "{}"、ある場合は "{CLSID}"。

出力引数: 
#define global IID_IShellDetails "{000214EC-0000-0000-C000-000000000046}"
#usecom global IShellDetails IID_IShellDetails "{}"
#comfunc global IShellDetails_GetDetailsOf  3 var,int,var
#comfunc global IShellDetails_ColumnClick   4 int
; ※数字は vtbl インデックス(0始まり)。0/1/2 は IUnknown(QueryInterface/AddRef/Release)。
; ※このインターフェースは直接 CoCreateInstance するクラスIDが無いため "{}"(他メソッド/アクティベーションで取得)。
; ※出力/バッファ引数は var(変数直渡し)。varptr 方式にも切替可。