Bibliothèques de classes d’éléments de rapport personnalisées

  • Article

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 managées qui encapsulent les fonctionnalités d'éléments RDL (Report Definition Language) pertinents. Pour un exemple de code montrant comment utiliser ces classes, consultez SQL Server Reporting Services Product Samples (Exemples Reporting Services pour le produit SQL Server).

Classes d’infrastructure d’éléments de rapport personnalisées

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

Notes

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

Microsoft.ReportDesigner.CustomReportItemDesigner est la classe d’élément de rapport personnalisée principale. La principale classe de votre implémentation d'élément de rapport personnalisé doit hériter de cette classe.

Propriétés publiques

Propriété Description
Nom Nom de l'élément de rapport personnalisé.
Type Type de l'élément de rapport personnalisé.
CustomData Objet 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 d’élément de rapport de remplacement, à utiliser où le contrôle d’exécution 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 d'ornement utilisée pour modifier de manière interactive le contrôle.
Site ISite du composant.
DesignerVerbCollection Tableau de verbes personnalisés pour le menu contextuel du contrôle.

Méthodes publiques

Méthode Description
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

Microsoft.ReportDesigner.CustomReportItemAttribute est l’attribut utilisé pour 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

Méthode Description
CustomReportItemAttribute Construit l'objet CustomReportItemAttribute.

Microsoft.ReportDesigner.LocalizedNameAttribute

Microsoft.ReportDesigner.LocalizedNameAttribute est l’attribut utilisé pour spécifier le nom complet à utiliser pour le concepteur d’éléments de rapport personnalisé.

Méthodes publiques

Méthode Description
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é pour définir des zones en dehors 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

Méthode Description
OnShow Appelé quand Adornment est activé.
OnHide Appelé quand Adornment est désactivé.
Paint Appelé en réponse à l’événement Paint.
OnDragEnter

OnDragOver

OnDragLeave

OnDragDrop		 Appelé quand 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

Propriété Description
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

Méthode Description
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

Méthode Description
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 elle sert à prendre en charge les événements glisser-déplacer dans l’environnement de conception. Hérite de IReportItemDataObject.

Propriétés publiques

Propriété Description
DataSetName Nom du dataset qui contient les champs à déplacer.
Fields Collection de champs (Microsoft.ReportDesigner.Field) à déplacer.

Contenu connexe

Langage de définition de rapport (SSRS, Report Definition Language)
Création d’un composant d’exécution d’élément de rapport personnalisé
Création d’un composant de conception d’élément de rapport personnalisé