Edit

Share via

IShellView interface (shobjidl_core.h)

  • Article

Exposes methods that present a view in the Windows Explorer or folder windows.

Inheritance

The IShellView interface inherits from IOleWindow. IShellView also has these types of members:

Methods

The IShellView interface has these methods.

 
IShellView::AddPropertySheetPages

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

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

Destroys the view window.
IShellView::EnableModeless

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

Gets the current folder settings.
IShellView::GetItemObject

Gets an interface that refers to data presented in the view.
IShellView::Refresh

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

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

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

Translates keyboard shortcut (accelerator) key strokes when a namespace extension's view has the focus.
IShellView::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.

Remarks

The object that exposes IShellView is typically 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 IID. This call succeeds only when made on the default Shell folder view object.

Requirements

Requirement Value
Minimum supported client Windows XP [desktop apps only]
Minimum supported server Windows 2000 Server [desktop apps only]
Target Platform Windows
Header shobjidl_core.h (include Shobjidl.h)