IShellView2 Interface

IID_IShellView2

{88E39E80-3578-11CF-AE69-08002B2E1262}

The IShellView2 interface extends the capabilities of IShellView.

Remarks

Implement IShellView2 if your namespace extension provides services to clients beyond those in IShellView.

You do not call this interface directly. IShellView2 is used by the operating system only when it has confirmed that your application is aware of this interface. Objects that expose IShellView and IShellView2 are usually created by other Shell folder objects.

 

IShellView2 implements all the IShellView methods as well as IUnknown. The listed methods are specific to IShellView2.

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.

IShellView2 Methods

Description

GetView

Used to request the current or default Shell view, together with all other valid view identifiers (VIDs) supported by this implementation of IShellView2.

CreateViewWindow2

Used to request the creation of a new Shell view window. It can be either the right pane of Microsoft Windows Explorer or the client window of a folder window.

HandleRename

Used to change an item's identifier.

SelectAndPositionItem

Used to select and position an item in a Shell View.

GetWindow

FUNCTION IShellView2_GetWindow ( _

  BYVAL pthis AS DWORD PTR _

, BYREF phwnd AS DWORD _

  ) AS LONG

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

END FUNCTION

ContextSensitiveHelp

FUNCTION IShellView2_ContextSensitiveHelp ( _

  BYVAL pthis AS DWORD PTR _

, BYVAL fEnterMode AS LONG _

  ) AS LONG

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

END FUNCTION

TranslateAccelerator

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

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

END FUNCTION

EnableModeless

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

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

END FUNCTION

UIActivate

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

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

END FUNCTION

Refresh

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

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

END FUNCTION

CreateViewWindow

FUNCTION IShellView2_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 IShellWiew2_CreateViewWindow (pthis, psvPrevious, pfs, psb, prcView, phWnd) TO HRESULT
  FUNCTION = HRESULT

END FUNCTION

DestroyViewWindow

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

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

END FUNCTION

GetCurrentInfo

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

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

END FUNCTION

AddPropertySheetPages

FUNCTION IShellView2_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 IShellView2_AddPropertySheetPages (pthis, dwReserved, pfn, lParam) TO HRESULT
  FUNCTION = HRESULT

END FUNCTION

SaveViewState

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

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

END FUNCTION

SelectItem

FUNCTION IShellView2_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 IShellView2_SelectItem (pthis, pidlItem, uFlags) TO HRESULT
  FUNCTION = HRESULT

END FUNCTION

GetItemObject

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

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

END FUNCTION

GetView

FUNCTION IShellView2_GetView ( _
  BYVAL pthis AS DWORD PTR _
, BYREF pvid AS DWORD _
, BYVAL iView AS DWORD _
  ) AS LONG

  LOCAL HRESULT AS LONG
  CALL DWORD @@pthis[16] USING IShellView2_GetView (pthis, uItem, pvid, iView) TO HRESULT
  FUNCTION = HRESULT

END FUNCTION

CreateViewWindow2

FUNCTION IShellView2_CreateViewWindow2 ( _
  BYVAL pthis AS DWORD PTR _
, BYREF lParams AS SV2CVW2_PARAMS _
  ) AS LONG

  LOCAL HRESULT AS LONG
  CALL DWORD @@pthis[17] USING IShellView2_CreateViewWindow2 (pthis, lParams) TO HRESULT
  FUNCTION = HRESULT

END FUNCTION

HandleRename

FUNCTION IShellView2_HandleRename ( _
  BYVAL pthis AS DWORD PTR _
, BYVAL pidlNew AS DWORD _
  ) AS LONG

  LOCAL HRESULT AS LONG
  CALL DWORD @@pthis[18] USING IShellView2_HandleRename (pthis, pidlNew) TO HRESULT
  FUNCTION = HRESULT

END FUNCTION

SelectAndPositionItem

FUNCTION IShellView2_SelectAndPositionItem ( _
  BYVAL pthis AS DWORD PTR _
, BYVAL pidlItem AS DWORD _
, BYVAL uFlags AS DWORD _
, BYREF ppt AS POINTAPI _
  ) AS LONG

  LOCAL HRESULT AS LONG
  CALL DWORD @@pthis[19] USING IShellView2_SelectAndPositionItem (pthis, pidlItem, uFlags, ppt) TO HRESULT
  FUNCTION = HRESULT

END FUNCTION