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

IExplorerPaneVisibility

COM
📘 Microsoft Learn (日本語) · English
IIDe07010ec-bc17-44c0-97b0-46c7c95b9edc継承元IUnknown自前メソッド開始 vtbl3

公式ドキュメント

Windows エクスプローラーで IShellFolder 実装が使用し、どのペインを表示するかについてビューに提案を行います。

メソッド 1

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

vtbl 3 HRESULT GetPaneState(GUID* ep, DWORD* peps)

指定した Windows エクスプローラーのペインの表示状態を取得します。

epGUID*in

Windows エクスプローラーのペインを一意に識別する GUID への参照。Shlguid.h で定義されている次の定数のいずれかです。

EP_NavPane (cb316b22-25f7-42b8-8a09-540d23a43c2f)

Windows エクスプローラー ウィンドウの左側にあるペインで、フォルダーツリーと お気に入り をホストします。

EP_Commands (d9745868-ca5f-4a76-91cd-f5a129fbb076)

Windows エクスプローラー ウィンドウの上部に沿った コマンド モジュールです。

EP_Commands_Organize (72e81700-e3ec-4660-bf24-3c3b7b648806)

コマンド モジュール内の 整理 メニューです。

EP_Commands_View (21f7c32d-eeaa-439b-bb51-37b96fd6a943)

コマンド モジュール内の 表示 メニューです。

EP_DetailsPane (43abf98b-89b8-472d-b9ce-e69b8229f019)

Windows エクスプローラー ウィンドウの下部に沿ってメタデータを表示するペインです。

EP_PreviewPane (893c63d1-45c8-4d17-be19-223be71be365)

Windows エクスプローラー ウィンドウの右側にあるペインで、ファイルの大きな読み取りプレビューを表示します。

EP_QueryPane (65bcde4f-4f07-4f27-83a7-1afca4df7ddd)

検索を補助するクイック フィルター ボタンです。

EP_AdvQueryPane (b4e9db8b-34ba-4c39-b5cc-16a1bd2c411c)

検索を補助する追加のフィールドとオプションです。

EP_StatusBar (65fe56ce-5cfe-4bc4-ad8a-7ae3fe7e8f7c)

Windows 8 で導入: コピーやダウンロードなど、何らかの処理の進行状況を示すステータス バーです。

EP_Ribbon (d27524a8-c9f2-4834-a106-df8889fd4f37)

Windows 8 で導入: リボン。多くの Microsoft アプリケーションの上部でメニューやツールバーに代わったコントロールです。

pepsDWORD*outこのメソッドが返るとき、指定した Windows エクスプローラーのペインの表示状態を EXPLORERPANESTATE 定数のいずれかとして格納します。

戻り値

型: HRESULT

このメソッドが成功した場合は S_OK を返します。それ以外の場合は HRESULT エラー コードを返します。

解説(Remarks)

実装側が指定されたペインの状態を気にせず、そのため変更したくない場合は、実装側はメソッドに対して成功コードを返し、peps パラメーターに EPS_DONTCARE を返す必要があります。メソッドが失敗した場合は、peps パラメーターに EPS_DONTCARE が返されたものとして扱われます。

出典・ライセンス: 上記「公式ドキュメント」の内容は 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_IExplorerPaneVisibility "{E07010EC-BC17-44C0-97B0-46C7C95B9EDC}"
#usecom global IExplorerPaneVisibility IID_IExplorerPaneVisibility "{}"
#comfunc global IExplorerPaneVisibility_GetPaneState  3 var,var
; ※数字は vtbl インデックス(0始まり)。0/1/2 は IUnknown(QueryInterface/AddRef/Release)。
; ※このインターフェースは直接 CoCreateInstance するクラスIDが無いため "{}"(他メソッド/アクティベーションで取得)。
; ※出力/バッファ引数は var(変数直渡し)。varptr 方式にも切替可。