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