DetailsViewDesigner.PreFilterProperties(IDictionary) Método

Definição

Usado pelo designer para remover propriedades ou adicionar propriedades ao ecrã na Properties grelha 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 DetailsViewDesigner da classe para alterar a Properties grelha do DetailsView controlo em tempo de projeto. O exemplo torna a NamingContainer propriedade visível na Properties grelha.

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

Observações

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

Para o DetailsView controlo, o PreFilterProperties método define o BrowsableAttribute objeto da Fields propriedade para false quando o controlo está em modo template. Isto garante que uma coluna em modo modelo não pode ser eliminada usando a Fields caixa de diálogo.

Notas para Herdeiros

Substitua o PreFilterProperties(IDictionary) método para adicionar propriedades ou alterar atributos de 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