HierarchicalDataBoundControlDesigner.PreFilterProperties(IDictionary) Método

Definição

Usado pelo designer para remover propriedades ou adicionar propriedades adicionais ao ecrã na grelha de Propriedades ou para sombrear propriedades do controlo associado.

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)

Parâmetros

properties
IDictionary

Uma coleção que implementa as IDictionary propriedades adicionadas e sombreadas.

Exemplos

O seguinte exemplo de código mostra como sobrescrever o PreFilterProperties método numa classe herdada HierarchicalDataBoundControlDesigner da classe para alterar a grelha de Propriedades do HierarchicalDataBoundControl controlo no momento do projeto. O exemplo torna a NamingContainer propriedade visível na grelha de Propriedades .

// Shadow the control properties with design-time properties.
protected override void PreFilterProperties(IDictionary properties)
{
    string namingContainer = "NamingContainer";

    // Call the base method first.
    base.PreFilterProperties(properties);

    // Make the NamingContainery 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)

    Dim namingContainer As String = "NamingContainer"

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

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

Observações

Os designers de controlo utilizam métodos derivados do ComponentDesigner.PreFilterProperties método para sombrear várias propriedades de controlo com as correspondentes propriedades de tempo de projeto que o designer implementa, e para adicionar ou remover propriedades da grelha de Propriedades .

Para controlos derivados da HierarchicalDataBoundControl classe, o PreFilterProperties método cria propriedades em tempo de projeto para sombrear as DataSource propriedades e (e DataSourceID ).

Notas para Herdeiros

Substitua o PreFilterProperties(IDictionary) método para adicionar propriedades ou alterar os atributos das propriedades na coleção de propriedades em tempo de design. Certifique-se de chamar o método base antes de realizar outro processamento.

Aplica-se a

Ver também