IShellView：：CreateViewWindow 方法 (shobjidl_core.h)

發行項
03/05/2024

建立檢視視窗。這可以是 Windows 檔案總管的右窗格或資料夾視窗的客戶端視窗。

語法

HRESULT CreateViewWindow(
  [in]  IShellView        *psvPrevious,
  [in]  LPCFOLDERSETTINGS pfs,
  [in]  IShellBrowser     *psb,
  [in]  RECT              *prcView,
  [out] HWND              *phWnd
);

參數

[in] psvPrevious

類型： IShellView*

正在結束檢視視窗的 IShellView 介面位址。檢視可以使用此參數與先前相同實作的檢視進行通訊。此介面可用來將類似檢視之間的瀏覽優化。此指標可能是 NULL。

[in] pfs

類型： LPCFOLDERSETTINGS

FOLDERSETTINGS 結構的位址。檢視應該會在建立檢視時使用此檢視。

[in] psb

類型： IShellBrowser*

IShellBrowser 介面目前實例的位址。檢視應該呼叫這個介面的 AddRef 方法，並保留介面指標，以允許與 Windows 檔案總管窗口通訊。

[in] prcView

類型： RECT*

用戶端座標中新檢視的維度。

[out] phWnd

類型： HWND*

要建立之視窗句柄的位址。

傳回值

類型： HRESULT

如果成功，則傳回成功碼，否則傳回 COM 錯誤碼。使用 SUCCEEDED 和 FAILED 宏來判斷作業是否成功或失敗。

備註

通話應用程式的注意事項

需要建立檢視時呼叫這個方法。

實作者的注意事項

呼叫 GetViewStateStream 方法，建立您的檢視視窗並還原任何持續性狀態。儲存 IShellBrowser 指標以供進一步使用。

規格需求

需求	值
最低支援的用戶端	Windows XP [僅限傳統型應用程式]
最低支援的伺服器	Windows 2000 Server [僅限傳統型應用程式]
目標平台	Windows
標頭	shobjidl_core.h (包括 Shobjidl.h)
Dll	Shell32.dll (4.0 版或更新版本)

另請參閱

IShellView