Shell |
Use this component to get information about changes in the file system (copy, move or delete operations) and other changes relevant for shell operations.
Inheritance HierarchyNamespace: Jam.Shell
Assembly: ShellBrowser (in ShellBrowser.dll) Version: 7.2
SyntaxThe ShellChangeNotifier type exposes the following members.
Constructors| Name | Description | |
|---|---|---|
 | ShellChangeNotifier | Initializes a new instance of the ShellChangeNotifier class. |
Properties| Name | Description | |
|---|---|---|
 | Directories | The directories to receive change notifications for. Leave empty to receive change notifications for the whole file system. |
| Enabled | Set to true to enable listening to change notifications. |
| EventFilter | Allows to define which shell change events should be reported. |
| Recursive | Set to true, if change notifications for subfolders are desired as well. |
| Version | The current version of the ShellBrowser. |
| WatchDrives | Determines if "This PC" shall be watched recursively if no other directories are given. |
Methods| Name | Description | |
|---|---|---|
| AddItemIdList(ItemIdList) | Subscribes for notifications in the passed folder using current settings for Recursive and EventFilter. |
| AddItemIdList(ItemIdList, Boolean, NotificationEvents) | Subscribes for notifications in the passed folder using the passed settings. |
| BeginInit | Signals the object that initialization is starting. |
| BeginUpdate | Begins an update of a ShellChangeNotifier configuration. |
| Clear | Removes all directories from the Directories property and so watches the entire file system again. |
 | Dispose |
Remove reference to the ChangeNotifierCallBackForm
(Overrides ComponentDispose(Boolean)) |
| EndInit | Signals the object that initialization is complete. |
| EndUpdate | Ends an update. |
| IsUpdating | Gets a value indicating if BeginUpdate has been called without a matching EndUpdate. |
| OnChange | Fires the OnChange event, when something happened in the monitored directories. |
| OnChangePIDL | Fires the OnChange event, when something happened in the monitored directories. |
| RemoveItemIdList | Unregisters the folder given. |
| Restart | Restarts the change notifier if it is already started |
 | SendChangeNotify(NotificationEvents, String) | Sends a shell change notification to the system that informs other processes about a achange. |
| SendChangeNotify(NotificationEvents, String, String) | Sends a shell change notification to the system that informs other processes about a achange. |
| Start | Starts monitoring the paths in the Directories property |
| Stop | Stops monitoring the paths in the Directories property |
Events| Name | Description | |
|---|---|---|
 | Change | This event is fired when a change event was fired from the system for one of the monitored paths in the Directories property. |
| ChangePIDL | This event is fired when a change event for the given ItemIdList list of the given paths in the Directories property occured. |
Remarks
Use the Directories property to decide which parts of the shell namespace will be watched for changes, or add ItemIdLists via AddItemIdList(ItemIdList).
See Also