Edit

Share via


LoginViewDesigner.PreFilterProperties(IDictionary) Method

Definition

Used by the designer to remove properties from or add properties to the display in the Properties grid or to shadow properties of the associated control.

protected:
 override void PreFilterProperties(System::Collections::IDictionary ^ properties);
protected override void PreFilterProperties (System.Collections.IDictionary properties);
override this.PreFilterProperties : System.Collections.IDictionary -> unit
Protected Overrides Sub PreFilterProperties (properties As IDictionary)

Parameters

properties
IDictionary

A collection implementing the IDictionary of the added or shadowed properties.

Examples

The following code example shows how to override the PreFilterProperties method in a class that is inherited from the LoginViewDesigner class to change the Properties grid of a control that is derived from the LoginView class at design time. The example makes the NamingContainer property visible in the Properties grid.

// Shadow control properties with design-time properties.
protected override void PreFilterProperties(IDictionary properties)
{
    // Call the base method first.
    base.PreFilterProperties(properties);

    // Make the NamingContainer visible in the Properties grid.
    PropertyDescriptor selectProp = 
        (PropertyDescriptor)properties["NamingContainer"];
    properties["NamingContainer"] =
        TypeDescriptor.CreateProperty(selectProp.ComponentType, 
            selectProp, BrowsableAttribute.Yes);
} // PreFilterProperties
' Shadow control properties with design-time properties.
Protected Overrides Sub PreFilterProperties( _
    ByVal properties As IDictionary)

    ' Call the base method first.
    MyBase.PreFilterProperties(properties)

    ' Make the NamingContainer visible in the Properties grid.
    Dim selectProp As PropertyDescriptor = _
        CType(properties("NamingContainer"), PropertyDescriptor)
    properties("NamingContainer") = _
        TypeDescriptor.CreateProperty(selectProp.ComponentType, _
            selectProp, BrowsableAttribute.Yes)

End Sub

Remarks

Control designers use methods that are derived from the ComponentDesigner.PreFilterProperties method to shadow various control properties with corresponding design-time properties that the designer implements, and to add properties to or remove properties from the Properties grid.

The PreFilterProperties method applies the BrowsableAttribute attribute of the RoleGroups property so that it does not appear in the Properties grid.

Notes to Inheritors

Override the PreFilterProperties(IDictionary) method to add properties to, remove properties from, or change attributes of properties in the design-time property collection. Be sure to call the PreFilterProperties(IDictionary) base method before performing other processing.

Applies to

See also