Bibliotecas de clases de elementos de informe personalizadas

  • Artículo

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.

Contenido relacionado

Report Definition Language (SSRS)
Creación de un componente en tiempo de ejecución de elemento de informe personalizado
Creación de un componente en tiempo de diseño de elemento de informe personalizado