ShellFolderViewOC object

Forwards the events fired by a specified ShellFolderView object to corresponding ShellFolderViewOC event handlers.

Members

The ShellFolderViewOC object has these types of members:

Events

The ShellFolderViewOC object has these events.

Event Description
EnumDone Indicates that the ShellFolderView object has finished enumerating the folder's contents.
SelectionChanged Indicates that the selection state of one or more items in the view has changed.

 

Methods

The ShellFolderViewOC object has these methods.

Method Description
SetFolderView Forwards the events of the specified ShellFolderView object to the corresponding ShellFolderViewOC event handler.

 

Remarks

The ShellFolderView object fires two events, EnumDone and SelectionChanged, that are typically handled by applications. However, some applications must handle events from a series of ShellFolderView objects. For example, an application might host a WebBrowser control that allows users to navigate through a series of folders. Each folder has its own ShellFolderView object with its associated events. Handling these events can be difficult.

The ShellFolderViewOC object simplifies event handling for such scenarios. It allows applications to handle events for all ShellFolderView objects with a single pair of ShellFolderViewOC event handlers. Each time the user navigates to a new folder, the application passes the associated ShellFolderView object to the ShellFolderViewOC object by calling SetFolderView. Then, when an EnumDone or SelectionChanged event is fired, the ShellFolderViewOC object forwards the event to its own handler for processing.

Requirements

Requirement Value
Minimum supported client
Windows 2000 Professional, Windows XP [desktop apps only]
Minimum supported server
Windows Server 2003 [desktop apps only]
Header
Shldisp.h
IDL
Shldisp.idl
DLL
Shell32.dll (version 5.0 or later)

See also

ShellFolderView