FVSHOWINFO  YXPIB 

Contains information that the IFileViewer::ShowKLOQL3 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 ShowWindow3MEJBZS 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 RECTEZENA2 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.