Freigeben über


DetailsViewDesigner.PreFilterProperties(IDictionary) Methode

Definition

Wird vom Designer zum Entfernen von Eigenschaften aus der Anzeige im Properties-Raster, zum Hinzufügen von Eigenschaften oder zum Durchführen von Shadowing von Eigenschaften des zugeordneten Steuerelements verwendet.

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)

Parameter

properties
IDictionary

Eine Auflistung, die das IDictionary von hinzugefügten Eigenschaften und Shadowing-Eigenschaften implementiert.

Beispiele

Das folgende Codebeispiel zeigt, wie Sie die PreFilterProperties -Methode in einer Klasse überschreiben, die von der DetailsViewDesigner -Klasse geerbt wird, um das Properties Raster des DetailsView Steuerelements zur Entwurfszeit zu ändern. Im Beispiel wird die NamingContainer Eigenschaft im Properties Raster sichtbar.

// Shadow the 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 the 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

Hinweise

Steuerelementdesigner verwenden von der ComponentDesigner.PreFilterProperties -Methode abgeleitete Methoden, um verschiedene Steuerelementeigenschaften mit entsprechenden Entwurfszeiteigenschaften zu überschatten, die der Designer implementiert, und um Eigenschaften zum Raster hinzuzufügen oder daraus Properties zu entfernen.

Für das DetailsView Steuerelement legt die PreFilterProperties -Methode das BrowsableAttribute -Objekt der Fields -Eigenschaft auf false fest, wenn sich das Steuerelement im Vorlagenmodus befindet. Dadurch wird sichergestellt, dass eine Spalte, die sich im Vorlagenmodus befindet, nicht über das Fields Dialogfeld gelöscht werden kann.

Hinweise für Vererber

Überschreiben Sie die PreFilterProperties(IDictionary) -Methode, um Eigenschaften in der Entwurfszeiteigenschaftenauflistung hinzuzufügen oder Attribute von Eigenschaften zu ändern. Rufen Sie unbedingt die Basismethode auf, bevor Sie eine andere Verarbeitung ausführen.

Gilt für:

Weitere Informationen