Пользовательские библиотеки классов элементов отчета
Пользовательские элементы отчета используют классы из пространства имен Microsoft.ReportDesigner. Классы, используемые для реализации пользовательского элемента отчета, можно разделить на две основные группы: уникальные классы, созданные для поддержки инфраструктуры пользовательских элементов отчетов, и управляемые классы-оболочки, инкапсулирующие функциональные возможности соответствующих элементов языка определения отчетов. Образец кода для использования этих классов см. на странице Образцы продуктов служб SQL Server Reporting.
Классы инфраструктуры пользовательских элементов отчета
Для реализации пользовательского элемента отчета используются следующие классы.
Примечание.
Приводимые далее в таблицах списки неполны; в них перечислены только наиболее часто используемые методы и свойства для каждого класса.
Microsoft.ReportDesigner.CustomReportItemDesigner
Microsoft.ReportDesigner.CustomReportItemDesigner является основным пользовательским классом элемента отчета. Главный класс реализации пользовательского элемента отчета должен быть производным от этого класса.
Открытые свойства
Свойство | Описание |
---|---|
Имя | Имя пользовательского элемента отчета. |
Тип | Тип пользовательского элемента отчета. |
CustomData | Объект CustomData, инкапсулирующий свойства данных пользовательского элемента отчета, заданные во время разработки. |
CustomProperties | Коллекция пользовательских свойств пользовательского элемента отчета. |
Высота | Высота элемента управления пользовательского элемента отчета. |
Ширина | Ширина элемента управления пользовательского элемента отчета. |
Отчет | Контейнер для свойств уровня отчета, таких как список наборов данных отчета. |
AltReportItem | Альтернативный объект элемента отчета, используемый, где не поддерживается пользовательский элемент управления временем выполнения элемента отчета. |
Style | Свойства стиля для пользовательского элемента отчета. |
Adornment | Окно дополнения, используемое для интерактивного редактирования элемента управления. |
Сайт | ISite компонента. |
DesignerVerbCollection | Набор пользовательских команд, доступных через контекстное меню элемента управления. |
Открытые методы
Метод | Description |
---|---|
BeginEdit | Активизирует интерактивное редактирование элемента управления. |
DoDefaultAction | Вызывается двойным щелчком или нажатием клавиши ВВОД в элементе управления. |
EndEdit | Деактивирует интерактивное редактирование элемента управления. |
GetService | Возвращает объект, представляющий службу. |
InitializeNewComponent | Вызывается при создании нового пользовательского элемента отчета. |
Invalidate | Перерисовывает всю область элемента управления. |
OnDragEnter OnDragDrop |
Вызывается при перетаскивании объекта на элемент управления. |
OnPaint | Вызывается в ответ на событие Paint. |
Microsoft.ReportDesigner.CustomReportItemAttribute
Microsoft.ReportDesigner.CustomReportItemAttribute — это атрибут, используемый для идентификации типа пользовательского элемента отчета. Имя должно соответствовать значению атрибута <Name> элемента ReportItem в файле конфигурации конструктора отчетов.
Открытые методы
Метод | Description |
---|---|
CustomReportItemAttribute | Создает объект CustomReportItemAttribute. |
Microsoft.ReportDesigner.LocalizedNameAttribute
Microsoft.ReportDesigner.LocalizedNameAttribute — это атрибут, используемый для указания отображаемого имени для пользовательского конструктора элементов отчета.
Открытые методы
Метод | Description |
---|---|
LocalizedNameAttribute | Создает объект LocalizedNameAttribute. |
Microsoft.ReportDesigner.Adornment
Класс Adornment используется компонентом времени разработки пользовательского элемента отчета для предоставления областей за пределами основного прямоугольника области конструктора. Эти области могут обрабатывать события пользовательского интерфейса, такие как щелчки кнопкой мыши и операции перетаскивания.
Открытые методы
Метод | Description |
---|---|
OnShow | Вызывается при активации Adornment. |
OnHide | Вызывается при деактивации Adornment. |
Paint | Вызывается в ответ на событие Paint. |
OnDragEnter OnDragOver OnDragLeave OnDragDrop |
Вызывается при перетаскивании объекта в Adornment. |
Microsoft.ReportDesigner.AdornerService
Этот класс используется для предоставления коллекции служб отображения, используемых пользовательским элементом отчета для поддержки объектов Adornment для компонента времени разработки пользовательского элемента отчета.
Открытые свойства
Свойство | Description |
---|---|
AdornerWindowBounds | Границы окна Adorner. |
AdornerWindowRegion | Область окна Adorner. |
AdornerWindowGraphics | Графический контекст окна Adorner. |
Открытые методы
Метод | Description |
---|---|
ComponentRectInDesignerFrame | Возвращает границы компонента, преобразованные в координаты экрана конструктора. |
InvalidateAdorner | Делает недействительным окно Adorner. |
PointToAdorner | Возвращает точку в экранных координатах, преобразованных в координаты окна Adorner. |
Microsoft.ReportDesigner.ExpressionEditor
Этот класс можно использовать из элемента управления времени разработки пользовательского элемента отчета для вызова редактора выражений.
Открытые методы
Метод | Description |
---|---|
EditValue | Вызывает редактор выражений, инициализированный значением данного объекта. |
Microsoft.ReportDesigner.IFieldsDataObject
Этот класс представляет собой коллекцию полей Reporting Services и используется для поддержки событий перетаскивания в среде проектирования. Наследует от IReportItemDataObject.
Открытые свойства
Свойство | Description |
---|---|
DataSetName | Имя набора данных, содержащего поля, которые предназначены для перетаскивания. |
Поля | Коллекция полей (Microsoft.ReportDesigner.Field) для удаления. |
Связанный контент
Язык определения отчетов (SSRS)
Создание настраиваемого компонента времени выполнения элемента отчета
Создание пользовательского компонента конструктора элемента отчета