The IShellView interface is implemented to present a view in the Windows Explorer or folder windows. The object that exposes IShellView is created by a call to IShellFolder::CreateViewObject. This provides the channel of communication between a view object and the Explorer's outermost frame window. The communication involves the translation of messages, the state of the frame window (activated or deactivated), and the state of the document window (Activated or deactivated), the merging of menus, and toolbar items.
When to Implement
This interface is implemented by namespace extensions that want to represent themselves in the Explorer's namespace. This object is created by the IShellFolder object that hosts the view.
When to Use
These methods are used by the shell view's Explorer window to manipulate objects while they are active.
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 | Returns a handle to one of the windows participating in in-place activation. |
ContextSensitiveHelp | Determines whether context-sensitive help mode should be entered during an in-place activation session. |
IShellView Methods | Description |
TranslateAccelerator | Translates accelerator key strokes when a namespace extension's view has the focus. |
EnableModeless | Enables or disables modeless dialog boxes. Not in use by the Explorer at this time. |
EnableModelessSV | Not in use at this time. |
UIActivate | Passes a value when the state of the view window is changed by events not caused by the shell view itself. |
Refresh | Responds to user input to refresh the display. |
CreateViewWindow | Creates the view window. |
DestroyViewWindow | Destroys the view window. |
GetCurrentInfo | Returns the folder settings. |
AddPropertySheetPages | Allows the view to add pages to the options property sheet. |
SaveViewState | Saves the current view state into a stream obtained by the view by calling IShellBrowser::GetViewStateStream. |
SelectItem | Changes the state of items within the shell view window. |
GetItemObject | Allows callers to get an object that represents something in the view. |