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.