Método IShellView::CreateViewWindow (shobjidl_core.h)

  • Artigo

Cria uma janela de exibição. Pode ser o painel direito do Windows Explorer ou a janela do cliente de uma janela de pasta.

Sintaxe

HRESULT CreateViewWindow(
  [in]  IShellView        *psvPrevious,
  [in]  LPCFOLDERSETTINGS pfs,
  [in]  IShellBrowser     *psb,
  [in]  RECT              *prcView,
  [out] HWND              *phWnd
);

Parâmetros

[in] psvPrevious

Tipo: IShellView*

O endereço da interface IShellView da janela de exibição que está sendo encerrada. As exibições podem usar esse parâmetro para se comunicar com uma exibição anterior da mesma implementação. Essa interface pode ser usada para otimizar a navegação entre exibições semelhantes. Esse ponteiro pode ser NULL.

[in] pfs

Tipo: LPCFOLDERSETTINGS

O endereço de uma estrutura FOLDERSETTINGS . O modo de exibição deve usar isso ao criar sua exibição.

[in] psb

Tipo: IShellBrowser*

O endereço da instância atual da interface IShellBrowser . O modo de exibição deve chamar o método AddRef dessa interface e manter o ponteiro da interface para permitir a comunicação com a janela do Windows Explorer.

[in] prcView

Tipo: RECT*

As dimensões da nova exibição, nas coordenadas do cliente.

[out] phWnd

Tipo: HWND*

O endereço do identificador de janela que está sendo criado.

Retornar valor

Tipo: HRESULT

Retornará um código de êxito se tiver êxito ou um código de erro COM caso contrário. Use as macros SUCCEEDED e FAILED para determinar se a operação foi bem-sucedida ou falhou.

Comentários

Observações para aplicativos de chamada

Chame esse método quando a exibição precisar ser criada.

Observações aos implementadores

Crie sua janela de exibição e restaure qualquer estado persistente chamando o método GetViewStateStream . Armazene o ponteiro IShellBrowser para uso adicional.

Requisitos

Requisito Valor
Cliente mínimo com suporte Windows XP [somente aplicativos da área de trabalho]
Servidor mínimo com suporte Windows 2000 Server [somente aplicativos da área de trabalho]
Plataforma de Destino Windows
Cabeçalho shobjidl_core.h (inclua Shobjidl.h)
DLL Shell32.dll (versão 4.0 ou posterior)

Confira também

IShellView