Partager via


Bibliothèques de classes d'éléments de rapport personnalisés

Les éléments de rapport personnalisés utilisent des classes de l'espace de noms Microsoft.ReportDesigner. Les classes utilisées pour implémenter un élément de rapport personnalisé peuvent être divisées en deux catégories principales : les classes uniques conçues pour prendre en charge l'infrastructure d'éléments de rapport personnalisés et les classes wrapper gérées qui encapsulent les fonctionnalités d'éléments de RDL (Report Definition Language) (RDL) pertinents. Pour plus d'informations sur un exemple de code montrant comment utiliser ces classes, consultez SQL Server Reporting Services Product Samples (page éventuellement en anglais).

Classes d'infrastructure d'éléments de rapport personnalisés

Les classes suivantes sont utilisées pour implémenter un élément de rapport personnalisé.

[!REMARQUE]

Les tableaux suivants ne contiennent pas de listes exhaustives. Ils répertorient uniquement les propriétés les plus utilisées, ainsi que les méthodes de chaque classe.

Microsoft.ReportDesigner.CustomReportItemDesigner

Cette classe correspond à la principale classe d'élément de rapport personnalisé. La principale classe de votre implémentation d'élément de rapport personnalisé doit hériter de cette classe.

Propriétés publiques

Name

Nom de l'élément de rapport personnalisé.

Type

Type de l'élément de rapport personnalisé.

CustomData

Classe Microsoft.ReportingServices.ReportRendering.CustomReportItem.CustomData qui encapsule les propriétés des données de l'élément de rapport personnalisé, spécifiées au moment de la conception.

CustomProperties

Collection de propriétés personnalisées destinées à l'élément de rapport personnalisé.

Height

Hauteur du contrôle de l'élément de rapport personnalisé.

Width

Largeur du contrôle de l'élément de rapport personnalisé.

Report

Conteneur pour les propriétés figurant au niveau du rapport, telles que la liste des datasets contenus dans ce rapport.

AltReportItem

Objet de remplacement d'élément de rapport, à utiliser lorsque le contrôle DTC de l'élément de rapport personnalisé n'est pas pris en charge.

Style

Propriétés de style destinées à l'élément de rapport personnalisé.

Adornment

Fenêtre de dispositif de décoration utilisée pour modifier de manière interactive le contrôle.

Site

ISite du component.

DesignerVerbCollection

Tableau de verbes personnalisés destinés au menu contextuel du contrôle.

Méthodes publiques

BeginEdit

Active la modification interactive du contrôle.

DoDefaultAction

Appelé en cas de double-clic ou lorsque le bouton de retour du contrôle est enfoncé.

EndEdit

Désactive la modification interactive du contrôle.

GetService

Retourne un objet qui représente un service.

InitializeNewComponent

Appelé lorsqu'un nouvel élément de rapport personnalisé est créé.

Invalidate

Repeint l'intégralité de la surface du contrôle.

OnDragEnter

OnDragDrop

Appelé lorsqu'un objet est déplacé jusqu'au contrôle.

OnPaint

Appelé en réponse à l'événement Paint.

Microsoft.ReportDesigner.CustomReportItemAttribute

Cet attribut est utilisé afin d'identifier le type de l'élément de rapport personnalisé. Le nom doit correspondre à la valeur de l'attribut <Name> de l'élément ReportItem figurant dans le fichier de configuration du Concepteur de rapports.

Méthodes publiques

CustomReportItemAttribute

Construit l'objet CustomReportItemAttribute.

Microsoft.ReportDesigner.LocalizedNameAttribute

Cet attribut est utilisé pour spécifier le nom d'affichage à utiliser pour le concepteur d'éléments de rapport personnalisés.

Méthodes publiques

LocalizedNameAttribute

Construit l'objet LocalizedNameAttribute.

Microsoft.ReportDesigner.Adornment

La classe Adornment est utilisée par le composant de conception de l'élément de rapport personnalisé afin de définir des zones situées à l'extérieur du rectangle principal de l'aire de conception. Ces zones permettent de gérer les événements de l'interface utilisateur, tels que les clics de souris et les opérations de glisser-déplacer.

Méthodes publiques

OnShow

Appelé lorsque Adornment est activé.

OnHide

Appelé lorsque Adornment est désactivé.

Paint

Appelé en réponse à l'événement Paint.

OnDragEnter

OnDragOver

OnDragLeave

OnDragDrop

Appelé lorsqu'un objet est déplacé jusqu'à Adornment.

Microsoft.ReportDesigner.AdornerService

Cette classe est utilisée pour fournir la collection de services d'affichage utilisée par l'élément de rapport personnalisé, et ce afin de prendre en charge les objets Adornment destinés à son composant de conception.

Propriétés publiques

AdornerWindowBounds

Limites de la fenêtre de dispositif de décoration.

AdornerWindowRegion

Région de la fenêtre de dispositif de décoration.

AdornerWindowGraphics

Contexte graphique de la fenêtre de dispositif de décoration.

Méthodes publiques

ComponentRectInDesignerFrame

Retourne les limites du composant sous la forme de coordonnées de cadre compréhensibles par le concepteur.

InvalidateAdorner

Invalide la fenêtre de dispositif de décoration.

PointToAdorner

Retourne un point exprimé en coordonnées d'écran sous la forme de coordonnées compréhensibles par la fenêtre de dispositif de décoration.

Microsoft.ReportDesigner.ExpressionEditor

Cette classe peut être utilisée à partir du contrôle DTC de l'élément de rapport personnalisé afin d'appeler l'Éditeur d'expressions.

Méthodes publiques

EditValue

Appelle l'Éditeur d'expressions, alors initialisé avec une valeur d'objet donnée.

Microsoft.ReportDesigner.IFieldsDataObject

Cette classe est une collection de champs Reporting Services et est utilisée pour prendre en charge les événements glissé-déplacé dans un environnement de conception. Hérite de IReportItemDataObject.

Propriétés publiques

DataSetName

Nom du dataset qui contient les champs à déplacer.

Fields

Collection de champs Microsoft.ReportDesigner.Field) à déplacer.