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. |