IDesignerFilter Gränssnitt

Definition

Tillhandahåller ett gränssnitt som gör det möjligt för en designer att komma åt och filtrera ordlistorna för en TypeDescriptor som lagrar egenskapen, attributet och händelsebeskrivningarna som en komponentdesigner kan exponera för designtidsmiljön.

public interface class IDesignerFilter
public interface IDesignerFilter
type IDesignerFilter = interface
Public Interface IDesignerFilter
Härledda

Exempel

I följande exempel visas en åsidosättning av PreFilterProperties som lägger till en egenskap för designern i Properties window när designerns kontroll väljs vid designtillfället. Se exemplet för klassen för ControlDesigner ett komplett designerexempel som använder IDesignerFilter gränssnittet.

protected:
   [ReflectionPermission(SecurityAction::Demand, Flags=ReflectionPermissionFlag::MemberAccess)]
   virtual void PreFilterProperties( System::Collections::IDictionary^ properties ) override
   {
      properties->Add( "OutlineColor", TypeDescriptor::CreateProperty( TestControlDesigner::typeid, "OutlineColor", System::Drawing::Color::typeid, nullptr ) );
   }
// Adds a property to this designer's control at design time 
// that indicates the outline color to use. 
// The DesignOnlyAttribute ensures that the OutlineColor
// property is not serialized by the designer.
protected override void PreFilterProperties(System.Collections.IDictionary properties)
{
    PropertyDescriptor pd = TypeDescriptor.CreateProperty(
        typeof(ExampleControlDesigner), 
        "OutlineColor",
        typeof(System.Drawing.Color),
        new Attribute[] { new DesignOnlyAttribute(true) });

    properties.Add("OutlineColor", pd);
}
' Adds a property to this designer's control at design time 
' that indicates the outline color to use.
' The DesignOnlyAttribute ensures that the OutlineColor
' property is not serialized by the designer.
Protected Overrides Sub PreFilterProperties(ByVal properties As System.Collections.IDictionary)
    Dim pd As PropertyDescriptor = TypeDescriptor.CreateProperty( _
    GetType(ExampleControlDesigner), _
    "OutlineColor", _
    GetType(System.Drawing.Color), _
    New Attribute() {New DesignOnlyAttribute(True)})

    properties.Add("OutlineColor", pd)
End Sub

Kommentarer

IDesignerFilter gör det möjligt för en designer att filtrera den uppsättning egenskaper, attribut och händelsebeskrivningar som dess associerade komponent exponerar via en TypeDescriptor. Metoderna i det här gränssnittet vars namn börjar med Pre anropas omedelbart innan de metoder vars namn börjar med Post.

Om du vill lägga till attribut-, händelse- eller egenskapsbeskrivningar använder du en PreFilterAttributes, PreFilterEventseller PreFilterProperties -metod.

Om du vill ändra eller ta bort attribut,händelse- eller egenskapsbeskrivningar använder du en PostFilterAttributes, PostFilterEventseller PostFilterProperties -metod.

Metoder

Name Description
PostFilterAttributes(IDictionary)

När den åsidosätts i en härledd klass kan en designer ändra eller ta bort objekt från den uppsättning attribut som den exponerar via en TypeDescriptor.

PostFilterEvents(IDictionary)

När den åsidosätts i en härledd klass kan en designer ändra eller ta bort objekt från den uppsättning händelser som den exponerar via en TypeDescriptor.

PostFilterProperties(IDictionary)

När den åsidosätts i en härledd klass kan en designer ändra eller ta bort objekt från den uppsättning egenskaper som den exponerar via en TypeDescriptor.

PreFilterAttributes(IDictionary)

När den åsidosätts i en härledd klass kan en designer lägga till objekt i den uppsättning attribut som den exponerar via en TypeDescriptor.

PreFilterEvents(IDictionary)

När den åsidosätts i en härledd klass kan en designer lägga till objekt i den uppsättning händelser som den exponerar via en TypeDescriptor.

PreFilterProperties(IDictionary)

När den åsidosätts i en härledd klass kan en designer lägga till objekt i den uppsättning egenskaper som den exponerar via en TypeDescriptor.

Gäller för

Se även