IShellView2::GetView メソッド (shobjidl_core.h)

[アーティクル]
03/02/2024

現在または既定のシェルビューを、この IShellView2 の実装でサポートされている他のすべての有効なビュー識別子 (VID) と共に要求します。

構文

HRESULT GetView(
  [out] SHELLVIEWID *pvid,
  [in]  ULONG       uView
);

パラメーター

[out] pvid

型: SHELLVIEWID*

要求されたビューの GUID へのポインター。 Shlguid.h では、次のビューが定義されています。

VID_LargeIcons

{0057D0E0-3573-11CF-AE69-08002B2E1262}

VID_SmallIcons

{089000C0-3573-11CF-AE69-08002B2E1262}

VID_List

{0E1FA5E0-3573-11CF-AE69-08002B2E1262}

VID_Details

{137E7700-3573-11CF-AE69-08002B2E1262}

VID_Tile

{65F125E5-7BE1-4810-BA9D-D271C8432CE3}

[in] uView

種類: ULONG

要求されたビューの種類。

SV2GV_CURRENTVIEW

現在のシェルビュー。

SV2GV_DEFAULTVIEW

既定のシェルビュー。

戻り値

型: HRESULT

成功した場合はS_OKを返し、それ以外の場合は標準の COM エラーコードを返します。

注釈

IShellView2::GetView は"viewset" を取得します。これは、要求されたビュー (既定または現在) と、この IShellView2 インスタンスの他のすべての有効なビューです。 SV2GV_CURRENTVIEWで IShellView2::GetView を呼び出すと、現在のビューを表す GUID が返され、有効な VID も反復処理されます。この情報は、表示前に新しいビューを検証する際に後で使用するために格納されます。

ビューは、他の要因の影響を受ける場合もあります。グローバルユーザーの既定の VID およびビューモードは、ユーザーが [フォルダーオプション] ウィンドウの [すべてのフォルダーに適用] ボタンを押すと設定されます。 VID は IShellView2::GetView と SV2GV_CURRENTVIEW フラグで決定され、ビューモードは GetCurrentInfo から決定されます。ビューは、保存されたフォルダーの既定値の影響を受ける場合もあります。 Windows エクスプローラーは、ユーザーが以前にフォルダーにアクセスした場合に、VID とフォルダーの表示モードを保存します。場合によっては、移動元のフォルダーも、入力する新しいビューに対して作成されたビューモードに影響を与える可能性があります。

これらの並べ替え済みビューの優先順位は、一般に次のようになります。

保存されたフォルダーの既定値
グローバルユーザーの既定値
既定のビュー (SV2GV_DEFAULTVIEW)
前のビュー

[フォルダー オプション] で [各フォルダーのビュー設定を記憶する] オプションが選択されていない場合は、前のビューの優先度を高くできます。ポリシーなどの他の要因も有効になる可能性があるため、上記の一覧は非常に広範なガイドラインとしてのみ表示する必要があります。

要件

要件	値
サポートされている最小のクライアント	Windows 2000 Professional、Windows XP [デスクトップアプリのみ]
サポートされている最小のサーバー	Windows 2000 Server [デスクトップアプリのみ]
対象プラットフォーム	Windows
ヘッダー	shobjidl_core.h (Shobjidl.h を含む)
[DLL]	Shell32.dll (バージョン 4.71 以降)