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

IShellUIHelper4

COMIDispatch (デュアル)
✅ IDispatch を実装(デュアルインターフェース)。HSP では comobj 経由でメソッド名による遅延バインド呼び出しができます(vtableインデックス不要)。
IIDb36e6a53-8073-499e-824c-d776330a333e継承元IShellUIHelper3呼び出し名前(IDispatch) または vtbl自前メソッド開始 vtbl49

メソッド 18

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

vtbl 49 HRESULT msIsSiteMode(VARIANT_BOOL* pfSiteMode)
pfSiteModeVARIANT_BOOL*outサイトモード(ピン留めサイト)で動作しているかどうかを受け取る VARIANT_BOOL へのポインタである。
vtbl 50 HRESULT msSiteModeShowThumbBar()
vtbl 51 HRESULT msSiteModeAddThumbBarButton(LPWSTR bstrIconURL, LPWSTR bstrTooltip, VARIANT* pvarButtonID)
bstrIconURLLPWSTRinサムネイル ツールバーボタンに表示するアイコンの URL を指定する。
bstrTooltipLPWSTRinボタンに表示するツールチップ文字列を指定する。
pvarButtonIDVARIANT*out追加したボタンの識別子を受け取る VARIANT へのポインタである。
vtbl 52 HRESULT msSiteModeUpdateThumbBarButton(VARIANT ButtonID, VARIANT_BOOL fEnabled, VARIANT_BOOL fVisible)
ButtonIDVARIANTin更新対象のサムネイル ツールバーボタンの識別子を保持する VARIANT を指定する。
fEnabledVARIANT_BOOLinボタンを有効にするかどうかを示す VARIANT_BOOL を指定する。
fVisibleVARIANT_BOOLinボタンを表示するかどうかを示す VARIANT_BOOL を指定する。
vtbl 53 HRESULT msSiteModeSetIconOverlay(LPWSTR IconUrl, VARIANT* pvarDescription)
IconUrlLPWSTRinタスクバーボタンに重ねて表示するオーバーレイ アイコンの URL を指定する。
pvarDescriptionVARIANT*inオーバーレイ アイコンの説明文を保持する VARIANT へのポインタである。
vtbl 54 HRESULT msSiteModeClearIconOverlay()
vtbl 55 HRESULT msAddSiteMode()
vtbl 56 HRESULT msSiteModeCreateJumpList(LPWSTR bstrHeader)
bstrHeaderLPWSTRin作成するジャンプリストのカスタム カテゴリのヘッダー文字列を指定する。
vtbl 57 HRESULT msSiteModeAddJumpListItem(LPWSTR bstrName, LPWSTR bstrActionUri, LPWSTR bstrIconUri, VARIANT* pvarWindowType)
bstrNameLPWSTRinジャンプリストに追加する項目の表示名を指定する。
bstrActionUriLPWSTRin項目を選択した際に実行するアクションの URI を指定する。
bstrIconUriLPWSTRin項目に表示するアイコンの URI を指定する。
pvarWindowTypeVARIANT*in起動するウィンドウの種別を保持する VARIANT へのポインタである。
vtbl 58 HRESULT msSiteModeClearJumpList()
vtbl 59 HRESULT msSiteModeShowJumpList()
vtbl 60 HRESULT msSiteModeAddButtonStyle(VARIANT uiButtonID, LPWSTR bstrIconUrl, LPWSTR bstrTooltip, VARIANT* pvarStyleID)
uiButtonIDVARIANTinスタイルを追加する対象ボタンの識別子を保持する VARIANT を指定する。
bstrIconUrlLPWSTRinボタンスタイルに使用するアイコンの URL を指定する。
bstrTooltipLPWSTRinボタンスタイルに使用するツールチップ文字列を指定する。
pvarStyleIDVARIANT*out追加したスタイルの識別子を受け取る VARIANT へのポインタである。
vtbl 61 HRESULT msSiteModeShowButtonStyle(VARIANT uiButtonID, VARIANT uiStyleID)
uiButtonIDVARIANTinスタイルを適用する対象ボタンの識別子を保持する VARIANT を指定する。
uiStyleIDVARIANTin適用するボタンスタイルの識別子を保持する VARIANT を指定する。
vtbl 62 HRESULT msSiteModeActivate()
vtbl 63 HRESULT msIsSiteModeFirstRun(VARIANT_BOOL fPreserveState, VARIANT* puiFirstRun)
fPreserveStateVARIANT_BOOLin初回起動状態を保持するかどうかを示す VARIANT_BOOL を指定する。
puiFirstRunVARIANT*out初回起動かどうかを示す結果を受け取る VARIANT へのポインタである。
vtbl 64 HRESULT msAddTrackingProtectionList(LPWSTR URL, LPWSTR bstrFilterName)
URLLPWSTRin追加する追跡防止リストの URL を指定する。
bstrFilterNameLPWSTRin追跡防止リストに付ける表示名を指定する。
vtbl 65 HRESULT msTrackingProtectionEnabled(VARIANT_BOOL* pfEnabled)
pfEnabledVARIANT_BOOL*out追跡防止機能が有効かどうかを受け取る VARIANT_BOOL へのポインタである。
vtbl 66 HRESULT msActiveXFilteringEnabled(VARIANT_BOOL* pfEnabled)
pfEnabledVARIANT_BOOL*outActiveX フィルター処理が有効かどうかを受け取る VARIANT_BOOL へのポインタである。

HSP用 COM定義

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

出力引数: 
#define global IID_IShellUIHelper4 "{B36E6A53-8073-499E-824C-D776330A333E}"
#usecom global IShellUIHelper4 IID_IShellUIHelper4 "{64AB4BB7-111E-11D1-8F79-00C04FC2FBE1}"
#comfunc global IShellUIHelper4_msIsSiteMode                    49 var
#comfunc global IShellUIHelper4_msSiteModeShowThumbBar          50
#comfunc global IShellUIHelper4_msSiteModeAddThumbBarButton     51 wstr,wstr,var
#comfunc global IShellUIHelper4_msSiteModeUpdateThumbBarButton  52 int,int,int
#comfunc global IShellUIHelper4_msSiteModeSetIconOverlay        53 wstr,var
#comfunc global IShellUIHelper4_msSiteModeClearIconOverlay      54
#comfunc global IShellUIHelper4_msAddSiteMode                   55
#comfunc global IShellUIHelper4_msSiteModeCreateJumpList        56 wstr
#comfunc global IShellUIHelper4_msSiteModeAddJumpListItem       57 wstr,wstr,wstr,var
#comfunc global IShellUIHelper4_msSiteModeClearJumpList         58
#comfunc global IShellUIHelper4_msSiteModeShowJumpList          59
#comfunc global IShellUIHelper4_msSiteModeAddButtonStyle        60 int,wstr,wstr,var
#comfunc global IShellUIHelper4_msSiteModeShowButtonStyle       61 int,int
#comfunc global IShellUIHelper4_msSiteModeActivate              62
#comfunc global IShellUIHelper4_msIsSiteModeFirstRun            63 int,var
#comfunc global IShellUIHelper4_msAddTrackingProtectionList     64 wstr,wstr
#comfunc global IShellUIHelper4_msTrackingProtectionEnabled     65 var
#comfunc global IShellUIHelper4_msActiveXFilteringEnabled       66 var
; ※数字は vtbl インデックス(0始まり)。0/1/2 は IUnknown(QueryInterface/AddRef/Release)。
; ※#usecom 末尾は CoCreateInstance 用のクラスID(コクラスCLSID, SDKから自動取得)。
; ※出力/バッファ引数は var(変数直渡し)。varptr 方式にも切替可。
; ※IDispatch 実装。HSP では comobj 経由でメソッド名による呼び出しも可能(vtbl 不要)。