Bibliotecas de clases de elementos de informe personalizadas
Los elementos de informe personalizados usan las clases del espacio de nombres Microsoft.ReportDesigner. Las clases utilizadas para implementar un elemento de informe personalizado pueden estar agrupadas en dos categorías principales: las clases únicas diseñadas para admitir la infraestructura del elemento de informe personalizado y las clases contenedora administradas que encapsulan la funcionalidad de los elementos del lenguaje RDL (Report Definition Language) pertinentes. Para obtener un ejemplo de código que ilustre cómo se usan estas clases, vea Muestras de productos de SQL Server Reporting Services.
Clases de infraestructura de elementos de informe personalizados
Las clases siguientes se utilizan para implementar un elemento de informe personalizado.
Nota:
Las tablas siguientes no constituyen listas completas; incluyen solo las propiedades utilizadas de forma más habitual y los métodos para cada clase.
Microsoft.ReportDesigner.CustomReportItemDesigner
Microsoft.ReportDesigner.CustomReportItemDesigner es la clase de elemento de informe personalizada principal. La clase principal de la implementación del elemento de informe personalizado debe heredar de esta clase.
Propiedades públicas
| Propiedad | Descripción |
|---|---|
| Nombre | El nombre del elemento de informe personalizado. |
| Tipo | El tipo del elemento de informe personalizado. |
| CustomData | Un objeto CustomData que encapsula las propiedades de datos del elemento de informe personalizado especificado en el momento del diseño. |
| CustomProperties | Una colección de propiedades personalizadas para el elemento de informe personalizado. |
| Height | El alto del control de elemento de informe personalizado. |
| Width | El ancho del control de elemento de informe personalizado. |
| Report | Un contenedor para las propiedades del nivel de informe, como la lista de conjuntos de datos en el informe. |
| AltReportItem | Objeto de elemento de informe alternativo, que se va a usar cuando no se admite el control en tiempo de ejecución del elemento de informe personalizado. |
| Estilo | Las propiedades de estilo del elemento de informe personalizado. |
| Adornment | Una ventana de elementos gráficos utilizada para la edición interactiva del control. |
| Sitio | ISite del componente. |
| DesignerVerbCollection | Una matriz de verbos personalizados para el menú contextual del control. |
Métodos públicos
| Método | Descripción |
|---|---|
| BeginEdit | Activa la edición interactiva para el control. |
| DoDefaultAction | Se le llama al hacer doble clic o al presionar Retorno en el control. |
| EndEdit | Desactiva la edición interactiva para el control. |
| GetService | Devuelve un objeto , que representa un servicio. |
| InitializeNewComponent | Se llama cuando se crea un nuevo elemento de informe personalizado. |
| Invalidate | Vuelve a dibujar toda la superficie del control. |
| OnDragEnter OnDragDrop |
Se llama al arrastrar un objeto al control. |
| OnPaint | Se le llama como respuesta al evento Paint. |
Microsoft.ReportDesigner.CustomReportItemAttribute
Microsoft.ReportDesigner.CustomReportItemAttribute es el atributo que se usa para identificar el tipo del elemento de informe personalizado. El nombre debe coincidir con el valor del atributo <Name> del elemento ReportItem en el archivo de configuración del diseñador de informes.
Métodos públicos
| Método | Descripción |
|---|---|
| CustomReportItemAttribute | Construye el objeto CustomReportItemAttribute. |
Microsoft.ReportDesigner.LocalizedNameAttribute
Microsoft.ReportDesigner.LocalizedNameAttribute es el atributo que se usa para especificar el nombre para mostrar que se va a usar para el diseñador de elementos de informe personalizado.
Métodos públicos
| Método | Descripción |
|---|---|
| LocalizedNameAttribute | Construye el objeto LocalizedNameAttribute. |
Microsoft.ReportDesigner.Adornment
El componente de tiempo de diseño del elemento de informe personalizado utiliza la clase Adornment para proporcionar áreas fuera del rectángulo principal de la superficie de diseño. Estas áreas pueden administrar los eventos de interfaz de usuario, como los clics del mouse y las operaciones de arrastrar y colocar.
Métodos públicos
| Método | Descripción |
|---|---|
| OnShow | Se llama cuando se activa Adornment. |
| OnHide | Se llama cuando se desactiva Adornment. |
| Pintar | Se le llama como respuesta al evento Paint. |
| OnDragEnter OnDragOver OnDragLeave OnDragDrop |
Se llama cuando se arrastra un objeto a Adornment. |
Microsoft.ReportDesigner.AdornerService
Esta clase se usa para proporcionar una colección de servicios de presentación utilizada por el elemento de informe personalizado para admitir los objetos Adornment para el componente en tiempo de diseño del elemento de informe personalizado.
Propiedades públicas
| Propiedad | Descripción |
|---|---|
| AdornerWindowBounds | Los límites de la ventana de adorno. |
| AdornerWindowRegion | La región de la ventana de adorno. |
| AdornerWindowGraphics | Un contexto gráfico para la ventana de adorno. |
Métodos públicos
| Método | Descripción |
|---|---|
| ComponentRectInDesignerFrame | Devuelve los límites del componente traducidos en coordenadas de marco de diseñador. |
| InvalidateAdorner | Invalida la ventana de adorno. |
| PointToAdorner | Devuelve un punto en coordenadas de pantalla traducido en las coordenadas de ventana de adorno. |
Microsoft.ReportDesigner.ExpressionEditor
Esta clase se puede utilizar desde el control en tiempo de diseño del elemento de informe personalizado para invocar el editor de expresiones.
Métodos públicos
| Método | Descripción |
|---|---|
| EditValue | Invoca el editor de expresiones, inicializado con el valor del objeto determinado. |
Microsoft.ReportDesigner.IFieldsDataObject
Esta clase es una colección de campos de Reporting Services y se utiliza para admitir los eventos arrastrar y colocar en el entorno de diseño. Se hereda de IReportItemDataObject.
Propiedades públicas
| Propiedad | Descripción |
|---|---|
| DataSetName | El nombre del conjunto de datos que contiene los campos que se van a quitar. |
| Fields | Colección de campos (Microsoft.ReportDesigner.Field) que se va a quitar. |