IShellView Interface

IID_IShellView

{000214E3-0000-0000-C000-000000000046}

The IShellView interface is implemented to present a view in the Microsoft Windows Explorer or folder windows.

Remarks

The object that exposes IShellView is normally created by a call to the IShellFolder::CreateViewObject method. This provides the channel of communication between a view object and Windows Explorer's outermost frame window. The communication involves the translation of messages, the state of the frame window (activated or deactivated), the state of the document window (activated or deactivated), and the merging of menus and toolbar items.

 

This interface is implemented by namespace extensions that display themselves in Windows Explorer's namespace. This object is created by the IShellFolder object that hosts the view.

 

These methods are used by the Shell view's Windows Explorer window to manipulate objects while they are active.

IShellView is derived from IOleWindow. The listed methods are specific to IShellView.

 

A special instance of IShellView known as the default Shell folder view object can be created by calling SHCreateShellFolderView or SHCreateShellFolderViewEx. This instance can be differentiated from standard implementations by calling QueryInterface on an IShellView object using the IID_CDefView interface identifier (IID). This call succeeds only when made on the default Shell folder view object.

Methods in VTable order

IUnknown Methods

Description

QueryInterface

Returns pointers to supported interfaces.

AddRef

Increments reference count.

Release

Decrements reference count.

IOleWindow Methods

Description

GetWindow

Gets a window handle.

ContextSensitiveHelp

Controls enabling of context-sensitive help.

IShellView Methods

Description

TranslateAccelerator

Translates accelerator key strokes when a namespace extension's view has the focus.

EnableModeless

Enables or disables modeless dialog boxes. This method is not currently implemented.

UIActivate

Called when the activation state of the view window is changed by an event that is not caused by the Shell view itself. For example, if the TAB key is pressed when the tree has the focus, the view should be given the focus.

Refresh

Refreshes the view's contents in response to user input.

CreateViewWindow

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

DestroyViewWindow

Destroys the view window.

GetCurrentInfo

Retrieves the current folder settings.

AddPropertySheetPages

Allows the view to add pages to the Options property sheet from the View menu.

SaveViewState

Saves the Shell's view settings so the current state can be restored during a subsequent browsing session.

SelectItem

Changes the selection state of one or more items within the Shell view window.

GetItemObject

Retrieves an interface that refers to data presented in the view.

GetWindow

FUNCTION IShellView_GetWindow ( _

  BYVAL pthis AS DWORD PTR _

, BYREF phwnd AS DWORD _

  ) AS LONG

  LOCAL HRESULT AS LONG
  CALL DWORD @@pthis[3] USING IShellView_GetWindow (pthis, phwnd) TO HRESULT
  FUNCTION = HRESULT

END FUNCTION

ContextSensitiveHelp

FUNCTION IShellView_ContextSensitiveHelp ( _

  BYVAL pthis AS DWORD PTR _

, BYVAL fEnterMode AS LONG _

  ) AS LONG

  LOCAL HRESULT AS LONG
  CALL DWORD @@pthis[4] USING IShellView_ContextSensitiveHelp (pthis, fEnterMode) TO HRESULT
  FUNCTION = HRESULT

END FUNCTION

TranslateAccelerator

FUNCTION IShellView_TranslateAccelerator ( _
  BYVAL pthis AS DWORD PTR _
, BYREF pmsg AS tagMSG _
  ) AS LONG

  LOCAL HRESULT AS LONG
  CALL DWORD @@pthis[5] USING IShellView_TranslateAccelerator (pthis, pmsg) TO HRESULT
  FUNCTION = HRESULT

END FUNCTION

EnableModeless

FUNCTION IShellView_EnableModeless ( _
  BYVAL pthis AS DWORD PTR _
, BYVAL fEnable AS LONG _
  ) AS LONG

  LOCAL HRESULT AS LONG
  CALL DWORD @@pthis[6] USING IShellView_EnableModeless (pthis, fEnable) TO HRESULT
  FUNCTION = HRESULT

END FUNCTION

UIActivate

FUNCTION IShellView_UIActivate ( _
  BYVAL pthis AS DWORD PTR _
, BYVAL uState AS DWORD _
  ) AS LONG

  LOCAL HRESULT AS LONG
  CALL DWORD @@pthis[7] USING IShellView_UIActivate (pthis, uState) TO HRESULT
  FUNCTION = HRESULT

END FUNCTION

Refresh

FUNCTION IShellView_Refresh ( _
  BYVAL pthis AS DWORD PTR _
  ) AS LONG

  LOCAL HRESULT AS LONG
  CALL DWORD @@pthis[8] USING IShellView_Refresh (pthis) TO HRESULT
  FUNCTION = HRESULT

END FUNCTION

CreateViewWindow

FUNCTION IShellView_CreateViewWindow ( _
  BYVAL pthis AS DWORD PTR _
, BYVAL psvPrevious AS DWORD _
, BYREF pfs AS FOLDERSETTINGS _
, BYVAL psb AS DWORD _
, BYREF prcView AS RECT _
, BYREF phWnd AS DWORD _
  ) AS LONG

  LOCAL HRESULT AS LONG
  CALL DWORD @@pthis[9] USING IShellWiew_CreateViewWindow (pthis, psvPrevious, pfs, psb, prcView, phWnd) TO HRESULT
  FUNCTION = HRESULT

END FUNCTION

DestroyViewWindow

FUNCTION IShellWiew_DestroyViewWindow ( _
  BYVAL pthis AS DWORD PTR _
  ) AS LONG

  LOCAL HRESULT AS LONG
  CALL DWORD @@pthis[10] USING IShellView_DestroyViewWindow (pthis) TO HRESULT
  FUNCTION = HRESULT

END FUNCTION

GetCurrentInfo

FUNCTION IShellView_GetCurrentInfo ( _
  BYVAL pthis AS DWORD PTR _
, BYREF pfs AS FOLDERSETTINGS _
  ) AS LONG

  LOCAL HRESULT AS LONG
  CALL DWORD @@pthis[11] USING IShellView_GetCurrentInfo (pthis, pfs) TO HRESULT
  FUNCTION = HRESULT

END FUNCTION

AddPropertySheetPages

FUNCTION IShellView_AddPropertySheetPages ( _
  BYVAL pthis AS DWORD PTR _
, BYVAL dwReserved AS DWORD _
, BYVAL pfn AS LONG _
, BYVAL lParam AS LONG _
  ) AS LONG

  LOCAL HRESULT AS LONG
  CALL DWORD @@pthis[12] USING IShellView_AddPropertySheetPages (pthis, dwReserved, pfn, lParam) TO HRESULT
  FUNCTION = HRESULT

END FUNCTION

SaveViewState

FUNCTION IShellView_SaveViewState ( _
  BYVAL pthis AS DWORD PTR _
  ) AS LONG

  LOCAL HRESULT AS LONG
  CALL DWORD @@pthis[13] USING IShellView_SaveViewState (pthis) TO HRESULT
  FUNCTION = HRESULT

END FUNCTION

SelectItem

FUNCTION IShellView_SelectItem ( _
  BYVAL pthis AS DWORD PTR _
, BYVAL pidlItem AS DWORD _
, BYVAL uFlags AS DWORD _
  ) AS LONG

  LOCAL HRESULT AS LONG
  CALL DWORD @@pthis[14] USING IShellView_SelectItem (pthis, pidlItem, uFlags) TO HRESULT
  FUNCTION = HRESULT

END FUNCTION

GetItemObject

FUNCTION IShellView_GetItemObject ( _
  BYVAL pthis AS DWORD PTR _
, BYVAL uItem AS DWORD _
, BUREF riid AS GUID _
, BYREF ppv AS DWORD _
  ) AS LONG

  LOCAL HRESULT AS LONG
  CALL DWORD @@pthis[15] USING IShellView_GetItemObject (pthis, uItem, riid, ppv) TO HRESULT
  FUNCTION = HRESULT

END FUNCTION