ITypeDescriptorFilterService.FilterProperties(IComponent, 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.
Filtra as propriedades que um componente expõe por meio de um TypeDescriptor.
public:
bool FilterProperties(System::ComponentModel::IComponent ^ component, System::Collections::IDictionary ^ properties);
public bool FilterProperties (System.ComponentModel.IComponent component, System.Collections.IDictionary properties);
abstract member FilterProperties : System.ComponentModel.IComponent * System.Collections.IDictionary -> bool
Public Function FilterProperties (component As IComponent, properties As IDictionary) As Boolean
Parâmetros
- component
- IComponent
O componente para o qual filtrar as propriedades.
- properties
- IDictionary
Um dicionário de propriedades que pode ser modificado.
Retornos
true
se o conjunto de propriedades filtradas deve ser armazenado em cache; false
se o serviço de filtro deve consultar novamente.
Comentários
Esse método é chamado quando um usuário solicita um conjunto de propriedades para um componente. As propriedades são adicionadas ao dicionário com os nomes de propriedade como as chaves e os objetos correspondentes PropertyDescriptor como os valores. Os implementadores desse serviço podem adicionar, remover ou alterar entradas de propriedade no dicionário.
Notas aos Implementadores
Retornar false
somente quando necessário, pois consultas repetidas para o serviço de filtro de descritor de tipo podem diminuir o desempenho.