Export (0) Print
Expand All

ITypeDescriptorFilterService.FilterEvents Method

Filters the events that a component exposes through a TypeDescriptor.

Namespace:  System.ComponentModel.Design
Assembly:  System (in System.dll)

bool FilterEvents(
	IComponent component,
	IDictionary events


Type: System.ComponentModel.IComponent

The component to filter events for.

Type: System.Collections.IDictionary

A dictionary of events that can be modified.

Return Value

Type: System.Boolean
true if the set of filtered events is to be cached; false if the filter service must query again.

This method is called when a user requests a set of events for a component. The events are added to the dictionary with the event names as the keys and the corresponding EventDescriptor objects as the values. Implementers of this service can add, remove, or alter event entries in the dictionary.

Notes to Implementers

Return false only when necessary, because repeated queries to the type descriptor filter service can decrease performance.

.NET Framework

Supported in: 4.5, 4, 3.5, 3.0, 2.0, 1.1, 1.0

.NET Framework Client Profile

Supported in: 4, 3.5 SP1

Windows 8.1, Windows Server 2012 R2, Windows 8, Windows Server 2012, Windows 7, Windows Vista SP2, Windows Server 2008 (Server Core Role not supported), Windows Server 2008 R2 (Server Core Role supported with SP1 or later; Itanium not supported)

The .NET Framework does not support all versions of every platform. For a list of the supported versions, see .NET Framework System Requirements.

© 2014 Microsoft