FVSHOWINFO

Contains information that the IFileViewer::Show member function uses to display a file.

typedef struct {

DWORD cbSize; // size of structure, in bytes

HWND hwndOwner; // see below

int iShow; // see below

DWORD dwFlags; // see below

RECT rect; // see below

LPUNKNOWN punkrel; // see below

OLECHAR strNewFile[MAX_PATH]; // see below

} FVSHOWINFO, *LPFVSHOWINFO;

Members

hwndOwner

Handle of the owner window. When a file viewer creates a window to display a file, it should specify this handle as the owner of the window.

iShow

Show command. For a list of show commands, see the description of the ShowWindow function.

dwFlags

Show information flags. This member can be a combination of these values:

FVSIF_CANVIEWIT The file viewer can display the file.
FVSIF_NEWFAILED The file viewer specified a new file to display, but no viewer could display the file. The file viewer should either terminate or continue to display the previous file.
FVSIF_NEWFILE A drag and drop operation has dropped a file on the file viewer window. The file viewer passes the name of the file to the shell by copying the name to strNewFile. The shell attempts to load a file viewer that can display the new file.
FVSIF_PINNED A pinned window exists. A file viewer should either use the pinned window to display the file or set a new pinned window and display the file in it.
FVSIF_RECT rect contains valid data.

rect

Address of a RECT structure that specifies the size and position of the file viewer's window. This member is valid only if dwFlags includes the FVSIF_RECT value.

punkrel

Address of an interface whose Release member function is called by a new file viewer to release the previous file viewer. This member is used when a drag and drop operation drops a file on the file viewer's window.

strNewFile

Address of a string that specifies the name of a new file to display. A file viewer sets this member when a drag and drop operation drops a file on the file viewer's window.

The shell uses this structure to pass information to a file viewer, and a file viewer uses it to return information to the shell.