Estrutura FVSHOWINFO (shlobj.h)

Artigo
03/13/2023

Contém informações que o visualizador de arquivos usa para exibir um arquivo.

Sintaxe

typedef struct {
  DWORD    cbSize;
  HWND     hwndOwner;
  int      iShow;
  DWORD    dwFlags;
  RECT     rect;
  IUnknown *punkRel;
  OLECHAR  strNewFile[MAX_PATH];
} FVSHOWINFO, *LPFVSHOWINFO;

Membros

cbSize

Tipo: DWORD

O tamanho da estrutura em bytes.

hwndOwner

Digite: HWND

Um identificador de janela para o proprietário da janela em que o arquivo será exibido.

iShow

Tipo: int

O comando show para a janela. Esse parâmetro é um dos valores de SW_ detalhados em ShowWindow.

dwFlags

Tipo: DWORD

Sinalizadores que determinam o que o visualizador de arquivos exibe. Esse membro pode ser um ou mais dos valores a seguir.

FVSIF_CANVIEWIT

O visualizador de arquivos pode exibir o arquivo.

FVSIF_NEWFAILED

O visualizador de arquivos especificou um novo arquivo a ser exibido, mas nenhum visualizador pôde exibir o arquivo. O visualizador de arquivos deve continuar a exibir o arquivo anterior ou terminar.

FVSIF_NEWFILE

Uma operação de arrastar e soltar soltou um arquivo na janela do visualizador de arquivos. O visualizador de arquivos passa o nome do arquivo para o Shell copiando o nome para o membro strNewFile . O Shell tenta carregar um visualizador de arquivos que pode exibir o novo arquivo.

FVSIF_PINNED

Existe uma janela fixada. Um visualizador de arquivos deve usar a janela fixada para exibir o arquivo ou definir uma nova janela fixada e exibir o arquivo nela.

FVSIF_RECT

O membro rect contém dados válidos.

rect

Tipo: RECT

A estrutura RECT que especifica o tamanho e a posição da janela do visualizador de arquivos. Esse membro só será válido se o membro dwFlags incluir o valor FVSIF_RECT .

punkRel

Tipo: IUnknown*

O endereço de uma interface que tem seu método Release chamado por um novo visualizador de arquivos para liberar o visualizador de arquivos anterior. Esse membro é usado quando uma operação de arrastar e soltar solta um arquivo na janela do visualizador de arquivos.

strNewFile[MAX_PATH]

Tipo: OLECHAR[MAX_PATH]

O endereço de uma cadeia de caracteres que especifica o nome de um novo arquivo a ser exibido. Um visualizador de arquivos define esse membro quando uma operação de arrastar e soltar solta um arquivo na janela do visualizador de arquivos.

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]
Cabeçalho	shlobj.h

Share via