FVSHOWINFO-Struktur (shlobj.h)

Artikel
08/26/2023

Enthält Informationen, die der Datei-Viewer zum Anzeigen einer Datei verwendet.

Syntax

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

Member

cbSize

Art: DWORD

Die Größe der Struktur in Bytes.

hwndOwner

Typ: HWND

Ein Fensterhandle für den Besitzer des Fensters, in dem die Datei angezeigt wird.

iShow

Typ: int

Der Befehl show für das Fenster. Dieser Parameter ist einer der SW_ Werte, die in ShowWindow beschrieben sind.

dwFlags

Art: DWORD

Flags, die bestimmen, was der Datei-Viewer anzeigt. Bei diesem Member kann es sich um einen oder mehrere der folgenden Werte handeln.

FVSIF_CANVIEWIT

Der Datei-Viewer kann die Datei anzeigen.

FVSIF_NEWFAILED

Der Datei-Viewer gab eine neue Datei an, die angezeigt werden soll, aber kein Viewer konnte die Datei anzeigen. Der Datei-Viewer sollte entweder weiterhin die vorherige Datei anzeigen oder beenden.

FVSIF_NEWFILE

Ein Drag-and-Drop-Vorgang hat eine Datei im Dateianzeigefenster gelöscht. Der Datei-Viewer übergibt den Namen der Datei an die Shell, indem er den Namen in das element strNewFile kopiert. Die Shell versucht, einen Datei-Viewer zu laden, der die neue Datei anzeigen kann.

FVSIF_PINNED

Ein angeheftetes Fenster ist vorhanden. Ein Datei-Viewer sollte entweder das angeheftete Fenster verwenden, um die Datei anzuzeigen, oder ein neues angeheftetes Fenster festlegen und die Datei darin anzeigen.

FVSIF_RECT

Das Rect-Element enthält gültige Daten.

rect

Typ: RECT

Die RECT-Struktur , die die Größe und Position des Fensters des Datei-Viewers angibt. Dieser Member ist nur gültig, wenn der dwFlags-Member den FVSIF_RECT-Wert enthält.

punkRel

Typ: IUnknown*

Die Adresse einer Schnittstelle, deren Release-Methode von einem neuen Datei-Viewer aufgerufen wird, um den vorherigen Datei-Viewer freizugeben. Dieses Element wird verwendet, wenn ein Drag-and-Drop-Vorgang eine Datei im Fenster des Datei-Viewers ablöscht.

strNewFile[MAX_PATH]

Typ: OLECHAR[MAX_PATH]

Die Adresse einer Zeichenfolge, die den Namen einer neuen anzuzeigenden Datei angibt. Ein Datei-Viewer legt diesen Member fest, wenn ein Drag-and-Drop-Vorgang eine Datei im Fenster des Datei-Viewers abwirft.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows XP [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows 2000 Server [nur Desktop-Apps]
Kopfzeile	shlobj.h

Share via