Partilhar via


DetailsViewDesigner.PreFilterProperties(IDictionary) Método

Definição

Usado pelo designer para remover propriedades da exibição ou adicionar propriedades a ela na grade Properties, ou então para sombrear propriedades do controle 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 implementando o IDictionary das propriedades adicionadas e sombreadas.

Exemplos

O exemplo de código a seguir mostra como substituir o PreFilterProperties método em uma classe herdada da DetailsViewDesigner classe para alterar a Properties grade do controle em tempo de DetailsView design. O exemplo torna a NamingContainer propriedade visível na Properties grade.

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

Comentários

Os designers de controle usam métodos derivados do ComponentDesigner.PreFilterProperties método para sombrear várias propriedades de controle com propriedades de tempo de design correspondentes que o designer implementa e para adicionar propriedades ou remover propriedades da Properties grade.

Para o DetailsView controle, o PreFilterProperties método define o BrowsableAttribute objeto da Fields propriedade para false quando o controle está no modo de modelo. Isso garante que uma coluna que está no modo de modelo não possa ser excluída usando a Fields caixa de diálogo.

Notas aos Herdeiros

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

Aplica-se a

Confira também