Método IShellView2::GetView (shobjidl_core.h)

  • Artigo

Solicita a exibição do Shell atual ou padrão, juntamente com todos os outros VIDs (identificadores de exibição) válidos compatíveis com essa implementação do IShellView2.

Sintaxe

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

Parâmetros

[out] pvid

Tipo: SHELLVIEWID*

Um ponteiro para o GUID da exibição solicitada. As exibições a seguir são definidas em 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

Tipo: ULONG

O tipo de exibição solicitado.

SV2GV_CURRENTVIEW

Exibição do Shell atual.

SV2GV_DEFAULTVIEW

Exibição padrão do Shell.

Retornar valor

Tipo: HRESULT

Retorna S_OK se tiver êxito ou um código de erro COM padrão, caso contrário.

Comentários

IShellView2::GetView recupera um "viewset", que é o modo de exibição solicitado (padrão ou atual) junto com todas as outras exibições válidas para esta instância do IShellView2. Chamar IShellView2::GetView com o SV2GV_CURRENTVIEW retorna um GUID que representa a exibição atual e também itera por meio dos VIDs válidos. Essas informações são armazenadas para uso posterior na validação de uma nova exibição antes de serem exibidas.

A exibição também pode ser afetada por outros fatores. Um VID padrão do usuário global e o modo de exibição são definidos quando o usuário pressiona o botão Aplicar a Todas as Pastas na janela Opções de Pasta . A VID é determinada de IShellView2::GetView com o sinalizador SV2GV_CURRENTVIEW e o modo de exibição é determinado de GetCurrentInfo. A exibição também pode ser afetada pelo padrão de pasta persistente. O Windows Explorer salvará a VID e o modo de exibição de uma pasta se o usuário a tiver visitado anteriormente. Em alguns casos, a pasta da qual você está navegando também pode influenciar o modo de exibição criado para a nova exibição que você está inserindo.

A prioridade dessas exibições variadas geralmente pode ser considerada a seguinte:

  1. Padrão de pasta persistente
  2. Padrão do usuário global
  3. Exibição padrão (SV2GV_DEFAULTVIEW)
  4. Exibição anterior
A prioridade da exibição anterior poderá ser maior se a opção Lembrar as configurações de exibição de cada pasta não estiver selecionada em Opções de Pasta. Outros fatores, como políticas, também podem entrar em jogo, portanto, a lista acima deve ser vista apenas como uma diretriz muito ampla.

Requisitos

Requisito Valor
Cliente mínimo com suporte Windows 2000 Professional, 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.71 ou posterior)