Структура FVSHOWINFO (shlobj.h)

Статья
03/02/2024

Содержит сведения, которые средство просмотра файлов использует для отображения файла.

Синтаксис

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

Члены

cbSize

Тип: DWORD

Размер структуры в байтах.

hwndOwner

Тип: HWND

Дескриптор окна для владельца окна, в котором будет отображаться файл.

iShow

Тип: int

Команда show для окна. Этот параметр является одним из SW_ значений, описанных в разделе ShowWindow.

dwFlags

Тип: DWORD

Флаги, определяющие, что отображается в средстве просмотра файлов. Этот элемент может быть одним или несколькими из следующих значений.

FVSIF_CANVIEWIT

Средство просмотра файлов может отобразить файл.

FVSIF_NEWFAILED

Средство просмотра файлов указало новый файл для отображения, но средство просмотра не могло отобразить файл. Средство просмотра файлов должно продолжить отображение предыдущего файла или завершить работу.

FVSIF_NEWFILE

Операция перетаскивания привела к удалению файла в окне средства просмотра файлов. Средство просмотра файлов передает имя файла в оболочку, скопировав его в член strNewFile . Оболочка пытается загрузить средство просмотра файлов, которое может отображать новый файл.

FVSIF_PINNED

Закрепленное окно существует. Средство просмотра файлов должно использовать закрепленное окно для отображения файла или задать новое закрепленное окно и отобразить файл в нем.

FVSIF_RECT

Элемент rect содержит допустимые данные.

rect

Тип: RECT

Структура RECT , указывающая размер и положение окна средства просмотра файлов. Этот элемент действителен, только если элемент dwFlags содержит значение FVSIF_RECT .

punkRel

Тип: IUnknown*

Адрес интерфейса, который имеет метод Release , вызываемый новым средством просмотра файлов для выпуска предыдущего средства просмотра файлов. Этот член используется, когда операция перетаскивания удаляет файл в окно средства просмотра файлов.

strNewFile[MAX_PATH]

Тип: OLECHAR[MAX_PATH]

Адрес строки, указывающей имя нового файла для отображения. Средство просмотра файлов задает этот элемент, когда операция перетаскивания удаляет файл в окне средства просмотра файлов.

Требования

Требование	Значение
Минимальная версия клиента	Windows XP [только классические приложения]
Минимальная версия сервера	Windows 2000 Server [только классические приложения]
Верхняя часть	shlobj.h

Поделиться через