Bibliotecas de clases de elemento de informe personalizado
Los elementos de informe personalizados utilizan 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 más información sobre un ejemplo de código que muestre cómo usar estas clases, vea Ejemplos de SQL Server Reporting Services.
Clases de infraestructura del elemento de informe personalizado
Las clases siguientes se utilizan para implementar un elemento de informe personalizado.
[!NOTA]
Las tablas siguientes no constituyen listas completas; incluyen sólo las propiedades utilizadas de forma más habitual y los métodos para cada clase.
Microsoft.ReportDesigner.CustomReportItemDesigner
Ésta es la clase del elemento de informe personalizado principal. La clase principal de la implementación del elemento de informe personalizado debe heredar de esta clase.
Propiedades públicas
Name |
El nombre del elemento de informe personalizado. |
Type |
El tipo del elemento de informe personalizado. |
CustomData |
Una clase Microsoft.ReportingServices.ReportRendering.CustomReportItem.CustomData que encapsula las propiedades de datos del elemento de informe personalizado especificada en el momento del diseño. |
CustomProperties |
Una recopilación de las 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 |
El objeto de elemento de informe alternativo que se utilizará cuando no se admita el control en tiempo de ejecución del elemento de informe personalizado. |
Style |
Las propiedades de estilo del elemento de informe personalizado. |
Adornment |
Una ventana de elementos gráficos utilizada para la edición interactiva del control. |
Site |
ISite del component. |
DesignerVerbCollection |
Una matriz de verbos personalizados para el menú contextual del control. |
Métodos públicos
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
Este es el atributo utilizado 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
CustomReportItemAttribute |
Construye el objeto CustomReportItemAttribute. |
Microsoft.ReportDesigner.LocalizedNameAttribute
Este es el atributo que se utiliza para especificar el nombre para mostrar que debe usarse con el diseñador de elementos de informe personalizados.
Métodos públicos
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
OnShow |
Se llama cuando Adornment está activado. |
OnHide |
Se llama cuando Adornment está desactivado. |
Paint |
Se le llama como respuesta al evento Paint. |
OnDragEnter OnDragOver OnDragLeave OnDragDrop |
Se le llama cuando se arrastra un objeto a Adornment. |
Microsoft.ReportDesigner.AdornerService
Esta clase se utiliza para proporcionar una recopilació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
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
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
EditValue |
Invoca el editor de expresiones, inicializado con el valor del objeto determinado. |
Microsoft.ReportDesigner.IFieldsDataObject
Esta clase es una recopilación de campos Reporting Services y se utiliza para admitir los eventos arrastrar y colocar en el entorno de diseño. Hereda de IReportItemDataObject.
Propiedades públicas
DataSetName |
El nombre del conjunto de datos que contiene los campos que se van a quitar. |
Fields |
La recopilación de campos (Microsoft.ReportDesigner.Field) que se va a quitar. |