Export (0) Print
Expand All

IShellView::CreateViewWindow method

Creates a view window. This can be either the right pane of Windows Explorer or the client window of a folder window.

Syntax


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

Parameters

psvPrevious [in]

Type: IShellView*

The address of the IShellView interface of the view window being exited. Views can use this parameter to communicate with a previous view of the same implementation. This interface can be used to optimize browsing between like views. This pointer may be NULL.

pfs [in]

Type: LPCFOLDERSETTINGS

The address of a FOLDERSETTINGS structure. The view should use this when creating its view.

psb [in]

Type: IShellBrowser*

The address of the current instance of the IShellBrowser interface. The view should call this interface's AddRef method and keep the interface pointer to allow communication with the Windows Explorer window.

prcView [in]

Type: RECT*

The dimensions of the new view, in client coordinates.

phWnd [out]

Type: HWND*

The address of the window handle being created.

Return value

Type: HRESULT

Returns a success code if successful, or a COM error code otherwise. Use the SUCCEEDED and FAILED macros to determine whether the operation succeeded or failed.

Remarks

Notes to Calling applications

Call this method when the view needs to be created.

Notes to Implementers

Create your view window and restore any persistent state by calling the GetViewStateStream method. Store the IShellBrowser pointer for further use.

Requirements

Minimum supported client

Windows XP [desktop apps only]

Minimum supported server

Windows 2000 Server [desktop apps only]

Header

Shobjidl.h

IDL

Shobjidl.idl

DLL

Shell32.dll (version 4.0 or later)

See also

IShellView

 

 

Community Additions

ADD
Show:
© 2014 Microsoft