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

Folder

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

メソッド 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)
ppidFolderItems**outフォルダー内の項目のコレクション(FolderItems)を受け取るポインタである。
vtbl 12 HRESULT ParseName(LPWSTR bName, FolderItem** ppid)
bNameLPWSTRin解決する項目の表示名(相対名)を指定する。
ppidFolderItem**out解決された項目を表す FolderItem を受け取るポインタである。
vtbl 13 HRESULT NewFolder(LPWSTR bName, VARIANT vOptions)
bNameLPWSTRin新規作成するフォルダーの名前を指定する。
vOptionsVARIANTinフォルダー作成時のオプションを保持する VARIANT を指定する。
vtbl 14 HRESULT MoveHere(VARIANT vItem, VARIANT vOptions)
vItemVARIANTinこのフォルダーへ移動する項目(パスまたは FolderItems)を保持する VARIANT を指定する。
vOptionsVARIANTin移動操作のオプション(FOF_* 値)を保持する VARIANT を指定する。
vtbl 15 HRESULT CopyHere(VARIANT vItem, VARIANT vOptions)
vItemVARIANTinこのフォルダーへコピーする項目(パスまたは FolderItems)を保持する VARIANT を指定する。
vOptionsVARIANTinコピー操作のオプション(FOF_* 値)を保持する VARIANT を指定する。
vtbl 16 HRESULT GetDetailsOf(VARIANT vItem, INT iColumn, LPWSTR* pbs)
vItemVARIANTin詳細情報を取得する対象項目を保持する VARIANT を指定する。
iColumnINTin取得する詳細列のインデックスを指定する。
pbsLPWSTR*out指定した列の詳細情報を表す文字列を受け取るポインタである。

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 不要)。