NGWS SDK Documentation  

This is preliminary documentation and subject to change.
To comment on this topic, please send us email at ngwssdk@microsoft.com. Thanks!

ITypeDescriptorFilterService.FilterEvents

Provides a way to filter the events from a component that are displayed to the user.

[Visual Basic]
Function FilterEvents( _
   ByVal component As IComponent, _
   ByVal events As IDictionary _
) As Boolean
[C#]
bool FilterEvents(
   IComponent component,
   IDictionary events
);
[C++]
bool FilterEvents(
   IComponent* component,
   IDictionary* events
) = 0;
[JScript]
function FilterEvents(
   component : IComponent,
   events : IDictionary
) : Boolean;

Parameters

component
The component to filter events for.
events
A dictionary of events. Modifications to this dictionary may be made in place.

Return Value

The service should return true if the resulting set of filtered events can be cached; false if the filter service should be re-queried.

Remarks

This method is called when a user requests a set of events for a component. The events will be added to the dictionary with the event names as the keys. Implementers of this service may make changes, add, or remove events in the dictionary.

Notes to Implementers: Return false only when absolutely necessary, as it impacts performance.

See Also

ITypeDescriptorFilterService Interface | ITypeDescriptorFilterService Members | System.ComponentModel.Design Namespace