IDesignerFilter Gränssnitt
Definition
Viktigt
En del information gäller för förhandsversionen av en produkt och kan komma att ändras avsevärt innan produkten blir allmänt tillgänglig. Microsoft lämnar inga garantier, uttryckliga eller underförstådda, avseende informationen som visas här.
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. |