HierarchicalDataBoundControlDesigner.PreFilterProperties(IDictionary) Método
Definición
Importante
Parte de la información hace referencia a la versión preliminar del producto, que puede haberse modificado sustancialmente antes de lanzar la versión definitiva. Microsoft no otorga ninguna garantía, explícita o implícita, con respecto a la información proporcionada aquí.
La usa el diseñador para quitar o agregar propiedades en la presentación de la cuadrícula Propiedades, o para reemplazar propiedades del control asociado.
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
Colección que implementa el objeto IDictionary de las propiedades agregadas y reemplazadas.
Ejemplos
En el ejemplo de código siguiente se muestra cómo invalidar el PreFilterProperties método en una clase que se hereda de la HierarchicalDataBoundControlDesigner clase para cambiar la cuadrícula Propiedades del HierarchicalDataBoundControl control en tiempo de diseño. En el ejemplo se hace visible la NamingContainer propiedad en la cuadrícula Propiedades .
// 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
Comentarios
Los diseñadores de controles usan métodos derivados del ComponentDesigner.PreFilterProperties método para sombrear varias propiedades de control con las propiedades en tiempo de diseño correspondientes que implementa el diseñador y para agregar o quitar propiedades de la cuadrícula Propiedades .
En el caso de los controles derivados de la HierarchicalDataBoundControl clase , el PreFilterProperties método crea propiedades en tiempo de diseño para sombrear las DataSource propiedades y DataSourceID .
Notas a los desarrolladores de herederos
Invalide el PreFilterProperties(IDictionary) método para agregar propiedades a o cambiar los atributos de las propiedades de la colección de propiedades en tiempo de diseño. Asegúrese de llamar al método base antes de realizar otro procesamiento.