IShellBrowser::GetViewStateStream メソッド (shobjidl_core.h)

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

ビュー固有の状態情報の格納に使用できる IStream インターフェイスを取得します。

構文

HRESULT GetViewStateStream(
  DWORD   grfMode,
  IStream **ppStrm
);

パラメーター

grfMode

型: DWORD

IStream インターフェイスの読み取り/書き込みアクセス。これは、次のいずれかの値になります。

STGM_READ

読み取りに適した IStream を要求します。

STGM_WRITE

書き込みに適した IStream を要求します。

STGM_READWRITE

読み取りと書き込みに適した IStream を要求します。

ppStrm

種類: IStream**

IStream インターフェイスポインターを受け取るアドレス。

戻り値

種類: HRESULT

成功した場合はS_OKを返し、それ以外の場合は COM 定義のエラー値を返します。

注釈

このメソッドは、ビューの永続的な状態 (アイコンの位置、列の幅、現在のスクロール位置など) を保存および復元するために使用されます。

呼び出し元のアプリケーションに関する注意事項

ビューが作成されている場合は GetViewStateStream を使用して、保存されたビューステートで読み取りを行い、ビューを閉じるときにもビューステートへの変更を保存します。通常、ビューは、ビューウィンドウを作成するときにSTGM_READを使用してこのメソッドを呼び出し、IShellView インターフェイスの SaveViewState メソッドが呼び出されたときにSTGM_WRITEを使用します。

実装者へのメモ

各シェルビューには、独自のビューストリームが必要です。 Windows エクスプローラーは、レジストリにユーザーごとに格納されるビューストリームの最新の使用 (MRU) リストを実装します。

IShellBrowser も参照してください

要件

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

Share via