Metodo IShellBrowser::GetViewStateStream (shobjidl_core.h)

Articolo
08/26/2023

Ottiene un'interfaccia IStream che può essere usata per l'archiviazione di informazioni sullo stato specifiche della visualizzazione.

Sintassi

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

Parametri

grfMode

Tipo: DWORD

Accesso in lettura/scrittura dell'interfaccia IStream . Può trattarsi di uno dei valori seguenti.

STGM_READ

Richiede un IStream adatto per la lettura.

STGM_WRITE

Richiede un IStream adatto per la scrittura.

STGM_READWRITE

Richiede un IStream adatto per la lettura e la scrittura.

ppStrm

Tipo: IStream**

Indirizzo che riceve il puntatore dell'interfaccia IStream .

Valore restituito

Tipo: HRESULT

Restituisce S_OK se ha esito positivo o un valore di errore definito da COM in caso contrario.

Commenti

Questo metodo viene usato per salvare e ripristinare lo stato permanente per una visualizzazione (le posizioni dell'icona, le larghezze delle colonne e la posizione di scorrimento corrente, ad esempio).

Note per la chiamata di applicazioni

Usare GetViewStateStream quando la visualizzazione viene creata per leggere nello stato di visualizzazione salvata e anche quando la visualizzazione viene chiusa per salvare eventuali modifiche allo stato di visualizzazione. In genere, la visualizzazione chiama questo metodo con STGM_READ durante la creazione di una finestra di visualizzazione e con STGM_WRITE quando viene chiamato il metodo SaveViewState dell'interfaccia IShellView .

Note per gli implementatori

Ogni visualizzazione shell deve avere un proprio flusso di visualizzazione. Esplora risorse implementa un elenco di flussi di visualizzazione usati più di recente in base all'utente nel Registro di sistema.

Vedere anche IShellBrowser

Requisiti

Requisito	Valore
Client minimo supportato	Windows XP [solo app desktop]
Server minimo supportato	Windows 2000 Server [solo app desktop]
Piattaforma di destinazione	Windows
Intestazione	shobjidl_core.h (include Shobjidl.h)
DLL	Shell32.dll (versione 4.0 o successiva)

Condividi tramite