IFolderViewOptions
COM公式ドキュメント
Windows 7 以降のビュー固有のフォルダービューオプションを制御するためのメソッドを公開します。
解説(Remarks)
実装するタイミング
このインターフェイスの実装は、CLSID_ExplorerBrowser および CLSID_ShellBrowser の一部として Windows によって提供されます。サードパーティがこのインターフェイスを実装することはありません。使用するタイミング
既定では、Windows 7 のアイテムビューは、Windows Vista のリストビューでサポートされていたカスタム位置指定、カスタム順序指定、ハイパーリンクをサポートしていません。これらの古いビューの機能が必要な場合に、このインターフェイスを使用してください。将来、アイテムビューがこれらの機能をサポートするようになった場合、これらのオプションは、現在のように古いビューへ切り替え続けるのではなく、自動的に新しいビューを使用するようになります。Windows 7 で新たに追加されたアニメーションおよびスクロールヒントのビューオプションを無効にするには、このインターフェイスを使用します。
これらすべてのオプションについて現在のビュー設定を取得するには、このインターフェイスを使用します。
メソッド 2
vtbl = vtable インデックス(0始まり)。HSP等からCOMメソッドをインデックス指定で呼ぶ際に使用します。0〜2 は IUnknown。
vtbl 3 HRESULT SetFolderViewOptions(FOLDERVIEWOPTIONS fvoMask, FOLDERVIEWOPTIONS fvoFlags)
ビューに対して指定したオプションを設定します。
| fvoMask | FOLDERVIEWOPTIONS | in | 変更対象のオプションを示す、1 つ以上の FOLDERVIEWOPTIONS フラグで構成されるビットマスクです。このマスクに含まれない fvoFlags の値は無視されます。 |
| fvoFlags | FOLDERVIEWOPTIONS | in | fvoMask で指定したオプションの新しい値を格納したビットマスクです。オプションを有効にするには、そのオプションに対応する FOLDERVIEWOPTIONS フラグをビットマスクに含めます。オプションを無効にするには、その FOLDERVIEWOPTIONS フラグに対応するビットを 0 にします。 |
戻り値
型: HRESULT
このメソッドが成功すると S_OK を返します。それ以外の場合は HRESULT エラーコードを返します。
vtbl 4 HRESULT GetFolderViewOptions(FOLDERVIEWOPTIONS* pfvoFlags)
ビューの現在のオプションセットを取得します。
| pfvoFlags | FOLDERVIEWOPTIONS* | out | このメソッドが正常に返ると、現在設定されている FOLDERVIEWOPTIONS の値を受け取るビットマスクです。 |
戻り値
型: HRESULT
このメソッドが成功すると S_OK を返します。それ以外の場合は HRESULT エラーコードを返します。
出典・ライセンス: 上記「公式ドキュメント」の内容は Microsoft の Win32 API ドキュメント(MicrosoftDocs/sdk-api)を日本語に翻訳・改変したものです。© Microsoft Corporation. CC BY 4.0 で提供。
Microsoft 公式リファレンス: 英語 (en-us) · 日本語 (ja-jp) · 原文ソース (GitHub)
Microsoft 公式リファレンス: 英語 (en-us) · 日本語 (ja-jp) · 原文ソース (GitHub)
HSP用 COM定義
#usecom / #comfunc によるHSPのCOM呼び出し定義。数字は vtbl インデックス(0始まり)。クラスIDが無い場合 #usecom の末尾は "{}"、ある場合は "{CLSID}"。
出力引数:
#define global IID_IFolderViewOptions "{3CC974D2-B302-4D36-AD3E-06D93F695D3F}" #usecom global IFolderViewOptions IID_IFolderViewOptions "{}" #comfunc global IFolderViewOptions_SetFolderViewOptions 3 int,int #comfunc global IFolderViewOptions_GetFolderViewOptions 4 var ; ※数字は vtbl インデックス(0始まり)。0/1/2 は IUnknown(QueryInterface/AddRef/Release)。 ; ※このインターフェースは直接 CoCreateInstance するクラスIDが無いため "{}"(他メソッド/アクティベーションで取得)。 ; ※出力/バッファ引数は var(変数直渡し)。varptr 方式にも切替可。#define global IID_IFolderViewOptions "{3CC974D2-B302-4D36-AD3E-06D93F695D3F}" #usecom global IFolderViewOptions IID_IFolderViewOptions "{}" #comfunc global IFolderViewOptions_SetFolderViewOptions 3 int,int #comfunc global IFolderViewOptions_GetFolderViewOptions 4 sptr ; ※数字は vtbl インデックス(0始まり)。0/1/2 は IUnknown(QueryInterface/AddRef/Release)。 ; ※このインターフェースは直接 CoCreateInstance するクラスIDが無いため "{}"(他メソッド/アクティベーションで取得)。 ; ※出力/バッファ引数はポインタ方式(token=sptr / 呼び出しは varptr(変数))。