HierarchicalDataBoundControlDesigner.PreFilterProperties(IDictionary) Método
Definição
Importante
Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.
Usado pelo designer para remover propriedades da exibição ou adicionar outras propriedades a ela na grade Propriedades ou 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 HierarchicalDataBoundControlDesigner classe para alterar a grade Propriedades do HierarchicalDataBoundControl controle em tempo de design. O exemplo torna a NamingContainer propriedade visível na grade 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
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 implementadas pelo designer e para adicionar propriedades à grade Propriedades ou remover propriedades.
Para controles derivados da HierarchicalDataBoundControl classe, o PreFilterProperties método cria propriedades de tempo de design para sombrear as propriedades e DataSourceID as DataSource propriedades.
Notas aos Herdeiros
Substitua o PreFilterProperties(IDictionary) método para adicionar propriedades ou alterar os atributos das propriedades na coleção de propriedades de tempo de design. Certifique-se de chamar o método base antes de executar outro processamento.