FVSHOWINFO info

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.