GridViewDesigner.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 GridViewDesigner para cambiar la cuadrícula Propiedades del GridView control en tiempo de diseño. En el ejemplo se hace visible la Page propiedad en la cuadrícula Propiedades .
// Shadow the control properties with design-time properties.
protected override void PreFilterProperties(IDictionary properties)
{
// Call the base method first.
base.PreFilterProperties(properties);
// Make the Page visible in the Properties grid.
PropertyDescriptor selectProp =
(PropertyDescriptor)properties["Page"];
properties["Page"] =
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 Page visible in the Properties grid.
Dim selectProp As PropertyDescriptor = _
CType(properties("Page"), PropertyDescriptor)
properties("Page") = _
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 .
Para el GridView control, el PreFilterProperties método establece el BrowsableAttribute objeto de la Columns propiedad false
en cuando el control está en modo de plantilla. Esto es así que una columna que está en modo de plantilla no se puede eliminar mediante el cuadro de diálogo Campos .
Notas a los desarrolladores de herederos
Invalide el PreFilterProperties(IDictionary) método para agregar propiedades o cambiar atributos de propiedades en la colección de propiedades en tiempo de diseño. Asegúrese de llamar al método base antes de realizar otro procesamiento.