ShellChangeNotifier Class |
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.1
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