FVSHOWINFO 結構 (shlobj.h)

發行項
03/05/2024

包含檔案查看器用來顯示檔案的資訊。

語法

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

成員

cbSize

類型： DWORD

結構的大小，以位元組為單位。

hwndOwner

類型： HWND

顯示檔案之窗口擁有者的視窗句柄。

iShow

類型： int

視窗的 show 命令。此參數是 ShowWindow 中詳述的其中一個SW_值。

dwFlags

類型： DWORD

旗標，決定檔案查看器顯示的內容。這個成員可以是下列一或多個值。

FVSIF_CANVIEWIT

檔案查看器可以顯示檔案。

FVSIF_NEWFAILED

檔案查看器指定要顯示的新檔案，但無法顯示檔案。檔案查看器應該繼續顯示上一個檔案或終止。

FVSIF_NEWFILE

拖放作業已卸除檔案查看器視窗上的檔案。檔案查看器會將檔名傳遞至Shell，方法是將名稱複製到 strNewFile 成員。 Shell 會嘗試載入可顯示新檔案的檔案查看器。

FVSIF_PINNED

釘選的視窗存在。檔案查看器應該使用釘選的視窗來顯示檔案，或設定新的釘選視窗，並在其中顯示檔案。

FVSIF_RECT

rect 成員包含有效的數據。

rect

類型： RECT

RECT 結構，指定檔案查看器視窗的大小和位置。只有當 dwFlags 成員包含 FVSIF_RECT 值時，這個成員才有效。

punkRel

類型： IUnknown*

介面的位址，其 Release 方法是由新的檔案查看器所呼叫，以釋放先前的檔案查看器。當拖放作業卸除檔案查看器視窗上的檔案時，會使用此成員。

strNewFile[MAX_PATH]

類型： OLECHAR[MAX_PATH]

字串的位址，指定要顯示之新檔案的名稱。當拖放作業在檔案查看器的視窗上卸除檔案時，檔案查看器會設定此成員。

規格需求

需求	值
最低支援的用戶端	Windows XP [僅限傳統型應用程式]
最低支援的伺服器	Windows 2000 Server [僅限傳統型應用程式]
標頭	shlobj.h

共用方式為