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

Folder

COMIDispatch (デュアル)
📘 Microsoft Learn (日本語) · English
✅ IDispatch を実装(デュアルインターフェース)。HSP では comobj 経由でメソッド名による遅延バインド呼び出しができます(vtableインデックス不要)。
IIDbbcbde60-c3ff-11ce-8350-444553540000継承元IDispatch呼び出し名前(IDispatch) または vtbl自前メソッド開始 vtbl7

公式ドキュメント

Shell フォルダーを表します。このオブジェクトには、フォルダーに関する情報を取得するためのプロパティとメソッドが含まれています。

解説(Remarks)

Shell フォルダーを表します。このオブジェクトには、フォルダーに関する情報を取得するためのプロパティとメソッドが含まれています。

メモ

すべてのメソッドがすべてのフォルダーに対して実装されているわけではありません。たとえば、ParseName メソッドはコントロール パネル フォルダー (CSIDL_CONTROLS) には実装されていません。実装されていないメソッドを呼び出そうとすると、0x800A01BD (10進数で 445) エラーが発生します。

メソッド 10

vtbl = vtable インデックス(0始まり)。IDispatch 実装のため HSP ではメソッド名でも呼べます(上記)。低レベルの index 呼び出し用に vtbl も掲載。0〜2 は IUnknown。

vtbl 7 HRESULT get_Title(LPWSTR* pbs)
pbsLPWSTR*outフォルダーの表示名(タイトル)を表す文字列を受け取るポインタである。
vtbl 8 HRESULT get_Application(IDispatch** ppid)
ppidIDispatch**outこのフォルダーを所有するアプリケーションオブジェクトを受け取る IDispatch へのポインタである。
vtbl 9 HRESULT get_Parent(IDispatch** ppid)
ppidIDispatch**outこのフォルダーの親オブジェクトを受け取る IDispatch へのポインタである。
vtbl 10 HRESULT get_ParentFolder(Folder** ppsf)
ppsfFolder**out親フォルダーを表す Folder を受け取るポインタである。
vtbl 11 HRESULT Items(FolderItems** ppid)

フォルダー内の項目のコレクションを表す FolderItems オブジェクトを取得します。

ppidFolderItems**outフォルダー内の項目のコレクション(FolderItems)を受け取るポインタである。
vtbl 12 HRESULT ParseName(LPWSTR bName, FolderItem** ppid)

指定した項目を表す FolderItem オブジェクトを作成して返します。

bNameLPWSTRin解決する項目の表示名(相対名)を指定する。
ppidFolderItem**out解決された項目を表す FolderItem を受け取るポインタである。
vtbl 13 HRESULT NewFolder(LPWSTR bName, VARIANT vOptions)

新しいフォルダーを作成します。

bNameLPWSTRin新規作成するフォルダーの名前を指定する。
vOptionsVARIANTinフォルダー作成時のオプションを保持する VARIANT を指定する。
vtbl 14 HRESULT MoveHere(VARIANT vItem, VARIANT vOptions)

1 つまたは複数の項目をこのフォルダーに移動します。

vItemVARIANTinこのフォルダーへ移動する項目(パスまたは FolderItems)を保持する VARIANT を指定する。
vOptionsVARIANTin移動操作のオプション(FOF_* 値)を保持する VARIANT を指定する。
vtbl 15 HRESULT CopyHere(VARIANT vItem, VARIANT vOptions)

1 つまたは複数の項目をフォルダーにコピーします。

vItemVARIANTinこのフォルダーへコピーする項目(パスまたは FolderItems)を保持する VARIANT を指定する。
vOptionsVARIANTinコピー操作のオプション(FOF_* 値)を保持する VARIANT を指定する。
vtbl 16 HRESULT GetDetailsOf(VARIANT vItem, INT iColumn, LPWSTR* pbs)

フォルダー内の項目に関する詳細を取得します。たとえば、サイズ、種類、最終更新日時などです。

vItemVARIANTin詳細情報を取得する対象項目を保持する VARIANT を指定する。
iColumnINTin取得する詳細列のインデックスを指定する。
pbsLPWSTR*out指定した列の詳細情報を表す文字列を受け取るポインタである。
出典・ライセンス: 上記「公式ドキュメント」の内容は Microsoft の Win32 API ドキュメント(MicrosoftDocs/sdk-api)を日本語に翻訳・改変したものです。© Microsoft Corporation. CC BY 4.0 で提供。
Microsoft 公式リファレンス: 英語 (en-us) · 日本語 (ja-jp)

HSP用 COM定義

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

出力引数: 
#define global IID_Folder "{BBCBDE60-C3FF-11CE-8350-444553540000}"
#usecom global Folder IID_Folder "{}"
#comfunc global Folder_get_Title         7 var
#comfunc global Folder_get_Application   8 sptr
#comfunc global Folder_get_Parent        9 sptr
#comfunc global Folder_get_ParentFolder  10 sptr
#comfunc global Folder_Items             11 sptr
#comfunc global Folder_ParseName         12 wstr,sptr
#comfunc global Folder_NewFolder         13 wstr,int
#comfunc global Folder_MoveHere          14 int,int
#comfunc global Folder_CopyHere          15 int,int
#comfunc global Folder_GetDetailsOf      16 int,int,var
; ※数字は vtbl インデックス(0始まり)。0/1/2 は IUnknown(QueryInterface/AddRef/Release)。
; ※このインターフェースは直接 CoCreateInstance するクラスIDが無いため "{}"(他メソッド/アクティベーションで取得)。
; ※出力/バッファ引数は var(変数直渡し)。varptr 方式にも切替可。
; ※ハンドル/void*等の不透明ポインタは IronHSP では intptr 指定が可能。
; ※IDispatch 実装。HSP では comobj 経由でメソッド名による呼び出しも可能(vtbl 不要)。