Bibliothèques de classes d’éléments de rapport personnalisées
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. |