Руководство разработчика

Объектный тип ТАБ_ФОРМА

Реализует интерфейсы: И_ФОРМА, И_КОМАНДЫ_ЭЛЕМЕНТА, И_ЭЛЕМЕНТЫ.

Физический объектный тип c закрытой моделью.

Тип ТАБ_ФОРМА предоставляет возможность программного взаимодействия с табличной формой, а также размещения в ячейках элементов управления модуля FC.

Дополнительные сведения о табличных формах можно найти в Руководстве разработчика.

Использование объектного типа ТАБ_ФОРМА и его методов в разработке пользовательского интерфейса см. Разработка табличных форм.

Поля типа

Методы:

Обработчики событий.

Поля

Тип Поле Описание Значение по умолчанию
ЦЕЛОЕ левыйПоложение левого края окна формы на экране в пикселях. Игнорируется при показе формы в дочернем MDI-окне или окне верхнего уровня, а также при установке поля центр равным ДА.150
ЦЕЛОЕ верхнийПоложение верхнего края окна формы на экране в пикселях. Игнорируется при показе формы в дочернем MDI-окне или окне верхнего уровня, а также при установке поля центр равным ДА.70
ЦЕЛОЕ ширинаШирина окна формы на экране в пикселях. Игнорируется при показе формы в дочернем MDI-окне или окне верхнего уровня при значении поля авто_размер равном ДА.500
ЦЕЛОЕ высотаВысота окна формы на экране в пикселях. Игнорируется при показе формы в дочернем MDI-окне или окне верхнего уровня при значении поля авто_размер равном ДА.400
ЛОГИКА центрЦентрировать форму относительно главного окна. Применяется только для всплывающих окон (popup), а для дочерних MDI-окон и окон верхнего уровня - игнорируется. ДА
ЛОГИКА авто_размерПрименяется только для дочерних MDI-окон и окон верхнего уровня. Включает автоматический выбор размера окна по размеру доступной области родительского окна или рабочего стола. Иначе используется значения полей ширина и высота. ДА
ЛОГИКА видимыйПризнак видимости формы на экране. ДА
СТРОКА идентИдентификатор формы, который может использоваться для сохранения настроек.
СТРОКА файлИмя файла статической части табличной формы. Имена файлов задаются относительно директории табличных форм. Если имя файла не задано (пустая строка), то создается новая форма.
ИКОНКА иконкаИконка окна табличной формы.

Для применения изменений полей необходимо вызвать метод ОБНОВИТЬ.

Методы

Методы общего назначения

МетодОписание
ПОКАЗАТЬ Создает окно табличной формы в режиме по умолчанию.
ПОКАЗАТЬ_МДИ Создает окно табличной формы в режиме дочернего MDI-окна.
ПОКАЗАТЬ_ВЕРХНЕГО_УРОВНЯ Создает окно табличной формы в режиме окна верхнего уровня.
ПОКАЗАТЬ_МОДАЛЬНЫЙ Отображает табличную форму в модальном диалоге.
ЭКЗЕМПЛЯР Возвращает строковый идентификатор экземпляра формы.
ОБНОВИТЬ Обновляет все элементы управления.
ПОКАЗАТЬ_МЕНЮ Отображает всплывающее меню.
СТАРТ_ТАЙМЕР_ЗАДЕРЖКИ Запускает именованный таймер задержки.
СТОП_ТАЙМЕР_ЗАДЕРЖКИ Останавливает работу именованного таймера задержки.
ЗАКРЫТЬ Закрывает окно формы.
ДОБАВИТЬ Динамически добавляет элемент управления.
УДАЛИТЬ Динамически удаляет элемент управления.
НАЙТИ_ЭЛЕМЕНТ Поиск элемента управления по строковому идентификатору.
ПЕЧАТЬ Выводит табличную форму на печать.
ПРОСМОТР Вызывает окно предварительного просмотра печати.
РАЗБИТЬ_НА_СТРАНИЦЫ Выполняет разбиение на страницы и возвращает количество страниц.
СЧИТАТЬ_ПАРАМ_СТРАНИЦЫ Позволяет получить текущие параметры страницы для окна табличной формы.
УСТ_ПАРАМ_СТРАНИЦЫ Устанавливает параметры страницы окна табличной формы.
АКТИВИРОВАТЬ Активирует окно табличной формы.
ЗАГРУЗИТЬ Загружает статическую часть табличной формы из файла.
СОХРАНИТЬ Сохраняет статическую часть табличной формы в файл.
ПОДСТАВИТЬ_ДАННЫЕ Позволяет осуществить подстановку данных в ячейки табличной формы унифицированным способом.
ЭКСПОРТ Осуществляет передачу внешнего вида табличной формы во внешние приложения.

Методы для работы с командами

МетодОписание
КОМАНДА Передает строковый код команды для выполнения форме.
КОМАНДА_ДЛЯ Передает строковый код команды для выполнения элементу с заданным идентификатором.
КОМАНДА_ДЛЯ_ВСЕХ Осуществляет широковещательную рассылку кода команды всем элементам управления.
КОМАНДА_РАЗР Устанавливает доступность стандартной команды.

Методы поддержки отката и изменений

МетодОписание
ОТМЕНИТЬ Отменяет последнее изменение статической части.
ПОВТОРИТЬ Возвращает отмененное изменение статической части.
ВОЗМ_ОТМЕНИТЬ Проверяет возможность отмены изменения.
ВОЗМ_ПОВТОРИТЬ Проверяет возможность возврата отмененного изменения.
РЕЖИМ_ОТМЕНЫ Возвращает текущее состояние режима регистрации изменений.
УСТ_РЕЖИМ_ОТМЕНЫ Включает или выключает режим регистрации изменений.

Методы работы с отображением формы

МетодОписание
КУР_ЯЧЕЙКА Позволяет получить информацию о ячейке, на которой стоит курсор.
УСТ_КУР Устанавливает курсор на заданную ячейку.
ВЫДЕЛЕНИЕ Позволяет получить список ячеек, захваченных множественным выделением.
СЧИТАТЬ_ПАРАМ_ВИДА Позволяет получить текущие параметры отображения: масштаб, видимость сетки и др.
УСТ_ПАРАМ_ВИДА Устанавливает параметры отображения: масштаб, видимость сетки и др.
УСТ_ПАН_ИНСТР Устанавливает панель инструментов окна табличной формы.
КОЛ_СТРАНИЦ Позволяет получить количество страниц табличной формы, когда эта информация доступна.
СТРАНИЦА_ЯЧЕЙКИ Позволяет получить номер страницы для заданной ячейки, когда эта информация доступна.
СТРАНИЦЫ_РАЗДЕЛА Позволяет получить список номеров страниц для заданного раздела, когда эта информация доступна.
ВЫСОТА_СТРОКИ Позволяет получить вычисленную высоту указанной строки.

Методы управления режимами внесения изменений

МетодОписание
СЧИТАТЬ_РЕЖ_ДОБАВЛЕНИЯ Позволяет получить текущий режим добавления строк и столбцов.
УСТ_РЕЖ_ДОБАВЛЕНИЯ Устанавливает режим добавления строк и столбцов.
СЧИТАТЬ_РЕЖ_УДАЛЕНИЯ Позволяет получить текущий режим удаления строк и столбцов.
УСТ_РЕЖ_УДАЛЕНИЯ Устанавливает режим удаления строк и столбцов.
СЧИТАТЬ_РЕЖ_ВСТАВКИ Позволяет получить текущий режим вставки строк и столбцов.
УСТ_РЕЖ_ВСТАВКИ Устанавливает режим вставки строк и столбцов.
СЧИТАТЬ_РЕЖ_ОБЪЕДИНЕНИЯ Позволяет получить текущий режим объединения ячеек.
УСТ_РЕЖ_ОБЪЕДИНЕНИЯ Устанавливает режим объединения ячеек.

Методы для работы с формой

МетодОписание
СЧИТАТЬ_ПАРАМ_ФОРМЫ Позволяет получить параметры формы.
УСТ_ПАРАМ_ФОРМЫ Устанавливает параметры формы.
ТЕКУЩИЕ_МЕТКИ Позволяет получить текущие значения меток формы.
ДОБАВИТЬ_МЕТКУ Добавляет описание метки формы.
ИЗМЕНИТЬ_МЕТКУ Изменяет описание метки формы.
УДАЛИТЬ_МЕТКУ Удаляет описание метки формы.
СЧИТАТЬ_МЕТКУ Позволяет получить описание метки формы.
ФИКС_ФОРМАТЫ Позволяет зафиксировать настраиваемые форматы в форме.
СБРОС_ФОРМАТОВ Удаляет из формы ранее зафиксированные настраиваемые форматы.

Методы для работы с разделами

МетодОписание
ВСТАВИТЬ_РАЗДЕЛ Добавляет новый раздел с заданным именем и типом в указанную позицию.
УДАЛИТЬ_РАЗДЕЛ Удаляет раздел с заданным именем.
ИМЯ_РАЗДЕЛА Возвращает имя раздела по позиции в форме.
ПОЗ_РАЗДЕЛА Возвращает позицию раздела в форме по его имени.
КОЛ_РАЗДЕЛОВ Позволяет получить количество разделов в форме.
РЕГ_РАЗДЕЛ Проверяет, является ли раздел с заданным именем регулярным.
СЧИТАТЬ_ПАРАМ_РАЗДЕЛА Позволяет получить параметры заданного раздела.
УСТ_ПАРАМ_РАЗДЕЛА Устанавливает параметры заданного раздела.
СЧИТАТЬ_РАЗМЕТКУ_ПЕЧАТИ Позволяет получить разметку печати раздела.
УСТ_РАЗМЕТКУ_ПЕЧАТИ Устанавливает разметку печати раздела.
СЧИТАТЬ_ДЗНАЧ_РАЗДЕЛА Считывает дополнительное значение раздела.
УСТ_ДЗНАЧ_РАЗДЕЛА Устанавливает дополнительное значение раздела.
КОПИРОВАТЬ_РАЗДЕЛЫ Копирует один или несколько последовательно расположенных разделов из одной формы в другую.
СПИСОК_ИДЕНТ_ЯЧЕЕК Позволяет получить список всех строковых идентификаторов ячеек, определенных в заданном разделе.
СПИСОК_ИДЕНТ_СТОЛБЦОВ Позволяет получить список всех строковых идентификаторов столбцов, определенных в заданном разделе.
СПИСОК_ИДЕНТ_СТРОК Позволяет получить список всех строковых идентификаторов строк, определенных в заданном разделе.

Методы для работы со строками

МетодОписание
ВСТАВИТЬ_СТРОКУ Добавляет новую строку перед указанной позицией в заданном разделе.
ДОБАВИТЬ_СТРОКУ Добавляет новую строку после указанной позиции в заданном разделе.
УДАЛИТЬ_СТРОКУ Удаляет строку в указанной позиции в заданном разделе.
ПОЗ_СТРОКИ Возвращает позицию строки в заданном разделе по строковому идентификатору.
КОЛ_СТРОК Возвращает количество строк в заданном разделе.
КОПИРОВАТЬ_СТРОКИ Копирует последовательность строк из одного раздела в другой.
СЧИТАТЬ_ПАРАМ_СТРОКИ Позволяет получить параметры строки.
УСТ_ПАРАМ_СТРОКИ Устанавливает параметры строки.
СЧИТАТЬ_ДЗНАЧ_СТРОКИ Считывает дополнительное значение строки.
УСТ_ДЗНАЧ_СТРОКИ Устанавливает дополнительное значение строки.
СЧИТАТЬ_ИДЕНТ_СТРОКИ Позволяет получить строковый идентификатор заданной строки.
УСТ_ИДЕНТ_СТРОКИ Устанавливает строковый идентификатор заданной строки.

Методы для работы со столбцами

МетодОписание
ВСТАВИТЬ_СТОЛБЕЦ Добавляет новый столбец перед указанной позицией в заданном разделе.
ДОБАВИТЬ_СТОЛБЕЦ Добавляет новый столбец после указанной позиции в заданном разделе.
УДАЛИТЬ_СТОЛБЕЦ Удаляет столбец в указанной позиции в заданном разделе.
КОПИРОВАТЬ_СТОЛБЦЫ Копирует последовательность столбцов регулярного раздела.
ПЕРЕМЕСТИТЬ_СТОЛБЦЫ Изменяет порядок столбцов в разделе.
ПОЗ_СТОЛБЦА Возвращает позицию столбца в разделе.
КОЛ_СТОЛБЦОВ Возвращает количество столбцов в разделе.
СЧИТАТЬ_ПАРАМ_СТОЛБЦА Позволяет получить параметры столбца.
УСТ_ПАРАМ_СТОЛБЦА Устанавливает параметры столбца.
СЧИТАТЬ_ДЗНАЧ_СТОЛБЦА Считывает дополнительное значение столбца.
УСТ_ДЗНАЧ_СТОЛБЦА Устанавливает дополнительное значение столбца.
СЧИТАТЬ_ИДЕНТ_СТОЛБЦА Позволяет получить строковый идентификатор заданного столбца.
УСТ_ИДЕНТ_СТОЛБЦА Устанавливает строковый идентификатор заданного столбца.

Методы для работы с ячейками

МетодОписание
ТИП_ЯЧЕЙКИ Возвращает тип заданной ячейки.
УСТ_ТИП_ЯЧЕЙКИ Устанавливает тип заданной ячейки.
ДАННЫЕ_ЯЧЕЙКИ Позволяет получить данные и соответствующие типу параметры ячейки.
УСТ_ДАННЫЕ_ЯЧЕЙКИ Устанавливает данные и соответствующие типу параметры ячейки.
СЧИТАТЬ_АТР_ЯЧЕЙКИ Позволяет получить независящие от типа атрибуты ячейки.
УСТ_АТР_ЯЧЕЙКИ Устанавливает независящие от типа атрибуты ячейки.
УСТ_АТР_ОБЛАСТИ Устанавливает независящие от типа атрибуты ячеек в указанной прямоугольной области.
СЧИТАТЬ_ДЗНАЧ_ЯЧЕЙКИ Считывает дополнительное значение ячейки.
УСТ_ДЗНАЧ_ЯЧЕЙКИ Устанавливает дополнительное значение ячейки.
СУЩ_ЯЧЕЙКА Проверяет существование заданной ячейки.
ПОЗ_ЯЧЕЙКИ Позволяет получить номер столбца и строки ячейки в указанном разделе по строковому идентификатору.
СЧИТАТЬ_ИДЕНТ_ЯЧЕЙКИ Позволяет получить строковый идентификатор заданной ячейки.
УСТ_ИДЕНТ_ЯЧЕЙКИ Устанавливает строковой идентификатор заданной ячейки.
ВСТАВИТЬ_ОБЪЕДИНЕНИЕ В регулярном разделе объединяет прямоугольную область ячеек.
УДАЛИТЬ_ОБЪЕДИНЕНИЕ Удаляет ранее добавленное объединение ячеек.
СЧИТАТЬ_ОБЪЕДИНЕНИЕ Проверяет, является ли заданная ячейка объединенной. Если да, то получает левую верхнюю и правую нижнюю ячейки объединения.
СЧИТАТЬ_ПАРАМ_ОБЪЕДИНЕНИЯ Позволяет получить параметры объединения для заданной ячейки.
УСТ_ПАРАМ_ОБЪЕДИНЕНИЯ Устанавливает параметры объединения для заданной ячейки.

Методы для работы с декорационными элементами

МетодОписание
ДОБАВИТЬ_ДЕКОР Добавляет новый декорационный элемент.
ИЗМЕНИТЬ_ДЕКОР Изменяет параметры существующего декорационного элемента в заданной ячейке.
УДАЛИТЬ_ДЕКОР Удаляет декорационный элемент с указанным именем в заданной ячейке.
ТИП_ДЕКОР Возвращает тип декорационного элемента с указанным именем в заданной ячейке.
СЧИТАТЬ_ДЕКОР Позволяет получить параметры декорационного элемента с указанным именем в заданной ячейке.

Методы для работы с границами

МетодОписание
ВСТАВИТЬ_ГРАНИЦУ Добавляет границу между двумя заданными ячейками или ячейкой и внешней областью.
УДАЛИТЬ_ГРАНИЦУ Удаляет границу между двумя заданными ячейками или ячейкой и внешней областью.
СЧИТАТЬ_ГРАНИЦУ Позволяет получить атрибуты границы между двумя заданными ячейками или ячейкой и внешней областью.
УСТ_ГРАНИЦЫ_ОБЛАСТИ Позволяет осуществить групповую установку границ внешнего контура или внутренних ячеек указанной прямоугольной области.
УДАЛИТЬ_ГРАНИЦЫ_ОБЛАСТИ Позволяет осуществить групповое удаление границ внешнего контура или внутренних ячеек указанной прямоугольной области.

Методы для работы со шрифтами

МетодОписание
СЧИТАТЬ_ОСН_ШРИФТ Позволяет получить основной шрифт табличной формы.
УСТ_ОСН_ШРИФТ Устанавливает основной шрифт табличной формы.
ДОБАВИТЬ_ШРИФТ Добавляет дополнительный шрифт с заданным именем.
УДАЛИТЬ_ШРИФТ Удаляет дополнительный шрифт с заданным именем.
УСТ_ШРИФТ Устанавливает новые параметры дополнительного шрифта.
СЧИТАТЬ_ШРИФТ Позволяет получить дополнительный шрифт с заданным именем.

Методы для работы с разрывами страниц

МетодОписание
ДОБАВИТЬ_АБС_РАЗРЫВ Добавляет разрыв страниц в абсолютной позиции от начала раздела.
ДОБАВИТЬ_РАЗРЫВ_СТРОК Добавляет горизонтальный разрыв страниц, привязанный к заданной строке.
ДОБАВИТЬ_РАЗРЫВ_СТОЛБЦОВ Добавляет вертикальный разрыв страниц, привязанный к заданному столбцу.
ДОБАВИТЬ_НЕРАЗРЫВНЫЕ_СТРОКИ Добавляет область неразрывных строк в заданном разделе.
ДОБАВИТЬ_НЕРАЗРЫВНЫЕ_СТОЛБЦЫ Добавляет область неразрывных столбцов в заданном разделе.

Обработчики событий

ОбработчикОписание
до_открытия Вызывается перед созданием окна формы. Может использоваться для эффективного заполнения табличной формы.
открытие Вызывается при открытии формы, но до ее показа на экране. Может использоваться для динамического формирования, добавления элементов управления и др.
после_открытия Вызывается после показа формы на экране. Может использоваться для печати формы или открытия других форм, т.к. не блокирует работу окна формы, в отличие от обработчика открытие.
закрытие Вызывается при закрытии формы пользователем или программно. Обработчик может запретить закрытие.
команда Вызывается при получении строковых команд от меню, панели инструментов, нажатии некоторых клавиш, получении некоторых стандартных команд, программной рассылке команд.
меню Вызывается при запросе на показ контекстного меню формы. По умолчанию никакое меню не показывается.
нажатие Вызывается при нажатии левой кнопки мыши или клавиши Enter для ячейки табличной формы.
изменение Вызывается при перемещении курсора табличной формы с одной ячейки на другую.
ячейка_изменена Вызывается после изменения ячейки в результате редактирования (в т.ч. специального) или действий с буфером обмена Правка/Вставить или Правка/Вырезать.
редактирование Вызывается перед созданием редактора ячейки для ячеек с атрибутом специального редактирования. Позволяет задать тип редактора, дополнительные параметры, редактируемое значение.
сохранение Вызывается при закрытии с сохранением изменений редактора ячейки для ячеек с атрибутом специального редактирования. Позволяет запомнить результат редактирования, произвести изменения в других ячейках, выполнить пересчет значений и т.п.
кнопка_редактора Вызывается при нажатии кнопки в редакторе ячейки. В качестве параметра передается строковый код нажатой кнопки.
макрос Позволяет выполнить вычисление значения для подстановки в ячейку типа "макрос". Значение может зависеть от номера страницы, расположенных на странице данных и т.п.
таймер_задержки Вызывается при срабатывании именованных таймеров задержек.

См. также: