Объектный тип ОТЧЕТ
Реализует интерфейсы: И_ФОРМА, И_КОМАНДЫ_ФОРМЫ.
Физический объектный тип c закрытой моделью.
Тип ОТЧЕТ предназначен для создания табличных отчетов различного вида и содержания. Типом ОТЧЕТ можно пользоваться для создания переменных, либо для определения производных типов.
Поля
Тип | Поле | Описание | Значение по умолчанию |
---|---|---|---|
ЦЕЛОЕ | левый | Положение левого края окна отчета на экране в пикселях. Игнорируется при показе отчета в дочернем MDI-окне или окне верхнего уровня, а также при установке поля центр равным ДА. | 150 |
ЦЕЛОЕ | верхний | Положение верхнего края окна отчета на экране в пикселях. Игнорируется при показе отчета в дочернем MDI-окне или окне верхнего уровня, а также при установке поля центр равным ДА. | 70 |
ЦЕЛОЕ | ширина | Ширина окна отчета на экране в пикселях. Игнорируется при показе отчета в дочернем MDI-окне или окне верхнего уровня при значении поля авто_размер равном ДА. | 500 |
ЦЕЛОЕ | высота | Высота окна отчета на экране в пикселях. Игнорируется при показе отчета в дочернем MDI-окне или окне верхнего уровня при значении поля авто_размер равном ДА. | 400 |
ЛОГИКА | центр | Центрировать отчет относительно главного окна. Применяется только для всплывающих окон (popup), а для дочерних MDI-окон и окон верхнего уровня - игнорируется. | ДА |
ЛОГИКА | авто_размер | Применяется только для дочерних MDI-окон и окон верхнего уровня. Включает автоматический выбор размера окна по размеру доступной области родительского окна или рабочего стола. Иначе используется значения полей ширина и высота. | ДА |
ЛОГИКА | видимый | Признак видимости отчета на экране. | ДА |
СТРОКА | идент | Идентификатор отчета, который может использоваться для сохранения настроек. | |
СТРОКА | заголовок | Заголовок окна отчета. | |
ИКОНКА | иконка | Иконка окна отчета. | |
СТРОКА | справка | Ссылка на топик файла справки прикладной разработки. | |
ПАРАМ_ПЕЧАТИ | парам_печати | Параметры вывода отчета на печать: поля, ориентация страницы и т.п. | |
ШАПКА | верх_шапка | Отображение верхней шапки отчета. | |
ШАПКА | ниж_шапка | Отображение нижней шапки отчета. | |
ЛОГИКА | многоуровн | Определяет, является отчет одно- или многоуровневым. ДА – отчет является многоуровневым. НЕТ – отчет определяется как одноуровневый, и никакие методы для добавления групп и работы с ними выполняться не будут. | |
ЛОГИКА | строка_сост | Определяет наличие строки состояния окна отчета. | ДА |
ЛОГИКА | редактируемый | В контекстное меню отчета добавляются пункты Добавить, Изменить и Удалить. Доступность этих команд изменяется вызовом метода КОМАНДА_РАЗР (по умолчанию команды недоступны). При разрешении команды Добавить в таблице отчета отображается строка добавления с символом "+". Подробнее см. Разрешение команд редактирования и Строка добавления | |
ЛОГИКА | подсветка_отрицательных | Отрицательные числа отображаются красным цветом. При значении ДА все отрицательные значения подсвечиваются принудительно. При значении НЕТ подсветка зависит от действующего в ячейке формата. | |
ШРИФТ: @[СТРОКА] | шрифты | Список шрифтов, упорядоченных по именам. Имена дополнительных шрифтов могут использоваться для шапок и колонтитулов. |
Для простоты задания данных многоуровневых отчетов введено понятие текущего уровня и средства входа в подуровень и выхода из подуровня. Таким образом, можно программно перемещаться по многоуровневому отчету, подобно перемещению по таблице с помощью мыши или клавиатуры. Методы задания и получения данных работают с текущим уровнем. Имеется возможность использовать для подуровней настройки столбцов вышестоящего уровня.
В зависимости от того, задан одно- или многоуровневый отчет, в таблице имеется один или два служебных фиксированных столбца. В первом столбце отображается позиция курсора, а во втором значок папки, указывающий на группу. Эти фиксированные столбцы в нумерации столбцов отчета не участвуют. Дополнительные же фиксированные столбцы участвуют в нумерации столбцов.
Данные отчета задаются в текстовом виде с помощью метода ЯЧЕЙКА. Получить данные по номеру строки и столбца можно с помощью метода ТЕКСТ. Текст ячеек и заголовков столбцов может содержать переносы строк, что приведет к автоматическому пересчету высоты табличной строки отчета и вывода текста в несколько строк. Многоуровневые отчеты формируются с помощью метода ДОБАВИТЬ_ГРУППУ. Перемещение по уровням отчета производится с помощью методов ВВЕРХ и ВНИЗ. С помощью метода СОРТИРОВКА можно отсортировать данные текущего уровня отчета по значениям указанного столбца.
Показ отчета на экране производится методом ПОКАЗАТЬ. Перерисовка отчета производится с помощью метода ОБНОВИТЬ.
Использование объектного типа ОТЧЕТ и его методов в разработке пользовательского интерфейса см. Разработка отчетов.
Методы
Метод | Описание |
---|---|
Общие методы | |
ПОКАЗАТЬ | Показывает отчет на экране в режиме по умолчанию. |
ПОКАЗАТЬ_МДИ | Показывает отчет на экране в режиме дочернего MDI-окна. |
ПОКАЗАТЬ_ВЕРХНЕГО_УРОВНЯ | Показывает отчет на экране в режиме окна верхнего уровня. |
ПОКАЗАТЬ_МОДАЛЬНЫЙ | Показывает отчет в модальном диалоге. |
ЗАКРЫТЬ | Закрывает отчет. |
ЭКЗЕМПЛЯР | Возвращает строковый идентификатор экземпляра отчета. |
ОБНОВИТЬ | Перерисовывает отчет. |
ПОКАЗАТЬ_МЕНЮ | Отображает всплывающее меню. |
СТАРТ_ТАЙМЕР_ЗАДЕРЖКИ | Запускает именованный таймер задержки. |
СТОП_ТАЙМЕР_ЗАДЕРЖКИ | Останавливает работу именованного таймера задержки. |
КОМАНДА | Выполняет обработку команды. |
КОМАНДА_РАЗР | Разрешает или запрещает стандартные команды для текущего уровня отчета. |
ПЕЧАТЬ | Выводит отчет на печать. |
ПРОСМОТР | Вызывает окно предварительного просмотра перед печатью. |
ЭКСПОРТ | Экспорт в офисное приложение. |
Навигация по уровням отчета | |
УРОВЕНЬ | Возвращает имя текущего уровня отчета. |
ВИДИМЫЙ_УРОВЕНЬ | Возвращает имя видимого на экране уровня отчета. |
ВЕРХНИЙ_УРОВЕНЬ | Возвращает имя уровня, вышестоящего по отношению к текущему уровню отчета. |
ВВЕРХ | Позволяет сделать текущим вышестоящий уровень отчета. |
ВНИЗ | Позволяет перейти на нижестоящий уровень указанной строки отчета. |
ПЕРЕЙТИ | Позволяет перейти на указанный уровень отчета. |
ИТОГИ | Переключает режим заполнения итоговых строк. |
Формирование столбцов отчета (схемы) | |
ДОБАВИТЬ_СТОЛБЕЦ | Позволяет добавить столбец в отчет. |
ВСТАВИТЬ_СТОЛБЕЦ | Позволяет добавить столбец перед указанным столбцом таблицы. |
УДАЛИТЬ_СТОЛБЕЦ | Удаляет из таблицы столбец с указанным именем. |
ПЕРЕМЕСТИТЬ_СТОЛБЕЦ | Позволяет переместить столбец с указанным именем. |
НАЙТИ_СТОЛБЕЦ | Возвращает номер столбца по его имени. |
ИМЯ_СТОЛБЦА | Возвращает имя столбца по его номеру. |
КОЛ_СТОЛБЦОВ | Возвращает количество видимых столбцов в таблице на текущем уровне отчета. |
ОБЪЕДИНИТЬ_СТОЛБЦЫ | Объединяет заданные столбцы таблицы. |
СЧИТАТЬ_ОБЪЕДИНЕНИЯ_СТОЛБЦОВ | Получает список всех объединений столбцов на текущем уровне отчета. |
ФОРМАТ_СТОЛБЦА | Возвращает формат, заданный для указанного столбца. |
УСТ_ФОРМАТ_СТОЛБЦА | Позволяет задать формат для указанного столбца. |
ИМЯ_СХЕМЫ | Возвращает имя схемы таблицы. |
УСТ_ИМЯ_СХЕМЫ | Позволяет задать имя схемы таблицы для текущего уровня отчета. |
СЧИТАТЬ_СХЕМУ | Позволяет получить для текущего уровня отчета настройки схемы таблицы. |
УСТАНОВИТЬ_СХЕМУ | Позволяет установить для текущего уровня отчета настройки схемы таблицы. |
СХЕМА_ПО_УМОЛЧ | Позволяет получить для текущего уровня отчета настройки схемы, которая ранее была установлена по умолчанию. |
УСТ_СХЕМУ_ПО_УМОЛЧ | Позволяет установить схему по умолчанию в качестве настроек для текущего уровня отчета. |
Операции со строками | |
ДОБАВИТЬ_СТРОКУ | Позволяет добавить строку в отчет. |
ВСТАВИТЬ_СТРОКУ | Позволяет добавить новую строку перед строкой с указанным номером. |
УДАЛИТЬ_СТРОКУ | Удаляет строку с указанным номером из таблицы. |
НАЙТИ_СТРОКУ | Возвращает номер строки по ее имени. |
ИМЯ_СТРОКИ | Возвращает имя строки по ее номеру. |
КОЛ_СТРОК | Возвращает количество строк в таблице на текущем уровне отчета. |
ДОБАВИТЬ_ГРУППУ | Позволяет создать подуровень отчета для строки с заданным номером. |
УДАЛИТЬ_ГРУППУ | Позволяет удалить признак группы для заданной строки отчета. |
НАЙТИ_ГРУППУ | Возвращает номер строки по имени уровня. |
ИМЯ_ГРУППЫ | Возвращает имя группы по номеру строки. |
АТРИБУТ_СТРОКИ | Возвращает атрибуты, заданные для строки с указанным номером. |
УСТ_АТРИБУТ_СТРОКИ | Позволяет задать атрибуты для указанной строки. |
ФОРМАТ_СТРОКИ | Возвращает формат, заданный для строки с указанным номером. |
УСТ_ФОРМАТ_СТРОКИ | Позволяет задать формат для указанной строки. |
ВЫСОТА_СТРОКИ | Возвращает высоту строки в пикселях. |
УСТ_ВЫСОТУ_СТРОКИ | Позволяет задать высоту строки в пикселях. |
Операции с ячейками | |
ТЕКСТ | Позволяет получить текст ячейки с заданными координатами на текущем уровне. |
ЗНАЧЕНИЕ | Позволяет получить значение ячейки с заданными координатами на текущем уровне. |
ЯЧЕЙКА | Позволяет задать текст ячейки на текущем уровне. |
ЯЧЕЙКА_ПОЗ | Позволяет задать текст ячейки на текущем уровне отчета. |
АТРИБУТ_ЯЧЕЙКИ | Позволяет получить дополнительные атрибуты указанной ячейки. |
УСТ_АТРИБУТ_ЯЧЕЙКИ | Позволяет задать дополнительные атрибуты указанной ячейки. |
ПОДСКАЗКА_ЯЧЕЙКИ | Позволяет получить текст всплывающей подсказки указанной ячейки. |
УСТ_ПОДСКАЗКУ_ЯЧЕЙКИ | Позволяет задать строку с текстом всплывающей подсказки для указанной ячейки. |
ФОРМАТ_ЯЧЕЙКИ | Возвращает формат, заданный для указанной ячейки. |
УСТ_ФОРМАТ_ЯЧЕЙКИ | Позволяет задать формат для указанной ячейки. |
ОБЪЕДИНИТЬ_ЯЧЕЙКИ | Позволяет объединить указанные ячейки в таблице. |
УДАЛИТЬ_ОБЪЕДИНЕНИЕ | Позволяет удалить объединение ячеек. |
СЧИТАТЬ_ОБЪЕДИНЕНИЯ | Получает список объединений для указанного диапазона строк. |
Сортировка | |
ДОБ_АТР_СОРТ | Позволяет добавить дополнительный атрибут сортировки для текущего уровня отчета. |
УДАЛ_АТР_СОРТ | Позволяет удалить ранее добавленный атрибут сортировки. |
АТР_СОРТ | Позволяет получить значение дополнительного атрибута сортировки. |
УСТ_АТР_СОРТ | Позволяет установить значение дополнительного атрибута сортировки. |
СОРТИРОВКА | Позволяет отсортировать данные текущего уровня отчета по тексту в указанных столбцах или по значениям дополнительных атрибутов сортировки. |
УСТ_СТАБ_СОРТ | Позволяет установить признак стабильной сортировки для текущего уровня отчета. . |
Прочие | |
ОЧИСТИТЬ | Удаляет все данные из отчета. |
УСТ_ПАН_ИНСТР | Позволяет задать панель инструментов для текущего уровня отчета. |
ПОЗ_КУРСОРА | Позволяет получить имя столбца и строки курсора в таблице отчета. |
УСТ_ПОЗ_КУРСОРА | Позволяет изменить положение курсора в таблице отчета. |
ВЫДЕЛЕНИЕ | Позволяет получить множественное выделение в таблице отчета. |
ЯЧЕИСТЫЙ | Позволяет установить вид курсора для текущего уровня отчета. |
УСТ_СТОЛБЕЦ_СОСТ | Позволяет задать имя столбца, текст из которого будет отражаться в строке состояния. |
УСТ_СТОЛБЕЦ_ПОИСКА | Позволяет задать имя столбца или дополнительного атрибута сортировки для поиска с клавиатуры. |
НУМЕРАЦИЯ | Позволяет установить ячейкам столбца текст, соответствующий возрастающей с номером строки нумерации. |
РАЗМЕР_ОБЛАСТИ | Позволяет вычислить размер видимой области таблицы отчета. |
Обработчики событий
Обработчик | Описание |
---|---|
до_открытия | Вызывается перед созданием окна отчета. Может использоваться для эффективного заполнения отчета. |
открытие | Вызывается перед показом окна отчета на экране. |
после_открытия | Вызывается после показа окна отчета на экране. |
закрытие | Вызывается при попытке закрытия окна отчета. |
команда | Вызывается при выборе пользователем пункта контекстного меню и при нажатии функциональных клавиш. |
меню | Вызывается при нажатии правой кнопки мыши в одной из ячеек отчета. |
выбор | Вызывается при выборе пользователем строки или ячейки отчета. |
настройка | Вызывается при нажатии кнопки настройки в левом верхнем углу отчета. |
сортировка | Вызывается при изменении пользователем условий сортировки по столбцам. |
вход | Вызывается при входе в группу. |
выход | Вызывается при выходе из группы. |
после_входа | Вызывается после входа в группу. |
после_выхода | Вызывается после выхода из группы. |
таймер_задержки | Вызывается при срабатывании именованных таймеров задержек. |