Модуль Таблица предназначен для работы с представлением данных в табличной форме. Данные хранятся в текстовом файле с разделителями символ табуляции. Действия модуля позволяют создавать, записывать, считывать данные. Таблица может создаваться в оперативной памяти и/или записываться на диск.
Действия модуля Таблица
Создать
Синтаксис:
[ИДМодуля]:Создать(ИДОкна).
Описание:
Действие создает элемент управления типа Календарь.
Родитель
Синтаксис:
[ИДМодуля]:Родитель(ИДОкна).
Описание:
Действие возвращает родитель модуля.
НоваяСтрока
Синтаксис:
[ИДМодуля]:НоваяСтрока.
Описание:
Действие добавляет новую строку в таблицу.
Получить
Синтаксис:
[ИДМодуля]:Получить(НомерСтроки; НомерКолонки).
Описание:
Действие возвращает значение в ячейке таблицы заданной параметрами НомерСтроки и НомерКолонки.
Установить
Синтаксис:
[ИДМодуля]:Установить(НомерСтроки; НомерКолонки;Значение).
Описание:
Действие устанавливает Значение в ячейку таблицы заданной параметрами НомерСтроки и НомерКолонки.
Очистить
Синтаксис:
[ИДМодуля]:Очистить.
Описание:
Действие удаляет все строки в таблице.
Открыть
Синтаксис:
[ИДМодуля]:Открыть(НазваниеФайла).
Описание:
Действие открывает таблицу из файла, указанного параметром НазваниеФайла.
Сохранить
Синтаксис:
[ИДМодуля]:Сохранить(НазваниеФайла).
Описание:
Действие сохраняет таблицу в файл, указанный параметром НазваниеФайла.
КоличествоСтрок
Синтаксис:
[ИДМодуля]:КоличествоСтрок.
Описание:
Действие Возвращает количество строк в таблице.
КоличествоКолонок
Синтаксис:
[ИДМодуля]:КоличествоКолонок.
Описание:
Действие возвращает количество колонок в таблице.
Сохранить
Синтаксис:
[ИДМодуля]:Сохранить(НазваниеФайла).
Описание:
Действие сохраняет таблицу в файл, указанный параметром НазваниеФайла.
ВыбратьГдеЧисло
Синтаксис:
[ИДМодуля]:ВыбратьГдеЧисло(Параметр1; Условие; Параметр2; ТаблицаРезультат).
Описание:
Действие выбирает строки таблицы соответствующие условию и заполняет ими Таблицу заданную параметром ТаблицаРезультат.
ВыбратьГдеСтрока
Синтаксис:
[ИДМодуля]:ВыбратьГдеСтрока(Параметр1; Условие; Параметр2; ТаблицаРезультат).
Описание:
Действие выбирает строки таблицы соответствующие условию и заполняет ими Таблицу заданную параметром ТаблицаРезультат.
ВыбратьГдеДата
Синтаксис:
[ИДМодуля]:ВыбратьГдеДата(Параметр1; Условие; Параметр2; ТаблицаРезультат).
Описание:
Действие выбирает строки таблицы соответствующие условию и заполняет ими Таблицу заданную параметром ТаблицаРезультат.
НайтиЗначение
Синтаксис:
[ИДМодуля]:НайтиЗначение(Что; Где).
Описание:
Действие ищет значение Что в колонке Где и возвращает номер строки.
СуммаПоКолонке
Синтаксис:
[ИДМодуля]:СуммаПоКолонке(НомерКолонки).
Описание:
Действие возвращает сумму значений в колонке таблицы заданной параметром НомерКолонки.
Макс
Синтаксис:
[ИДМодуля]:Макс(НомерКолонки).
Описание:
Действие возвращает максимальное значение в колонке заданной параметром НомерКолонки.
Мин
Синтаксис:
[ИДМодуля]:Мин(НомерКолонки).
Описание:
Действие возвращает минимальное значение в колонке заданной параметром НомерКолонки.
КолонкуВмассив
Синтаксис:
[ИДМодуля]:КолонкуВмассив(НомерКолонки; РезМассив).
Описание:
Действие переносит значения колонки НомерКолонки в массив РезМассив.
НоваяКолонка
Синтаксис:
[ИДМодуля]:НоваяКолонка.
Описание:
Действие добавляет новую колонку в таблицу.
УдалитьСтроку
Синтаксис:
[ИДМодуля]:УдалитьСтроку(НомерСтроки).
Описание:
Действие удаляет строку НомерСтроки из таблицы.
Сортировать
Синтаксис:
[ИДМодуля]:Сортировать(НомерКолонки; ТипСортировки).
Описание:
Действие сортирует таблицу по указанной колонке по указанному типу сортировки.
СортироватьКолонки
Синтаксис:
[ИДМодуля]:СортироватьКолонки(ПредставлениеКолонок).
Описание:
Действие сортирует таблицу по указанным колонкам. Параметр ПредставлениеКолонок - строка, в которой через точку с запятой указаны колонки, по которым нужно отсортировать таблицу. Например:
Запрос:СортироватьКолонки("1;3;2").
Загрузить
Синтаксис:
[ИДМодуля]:Загрузить(НазваниеФайла).
Описание:
Действие загружает таблицу из файла. Прараметр НазваниеФайла должен содержать полный путь к открываемому файлу.
ПолучитьПоКоду
Синтаксис:
[ИДМодуля]:ПолучитьПоКоду(ИндексСтроки; НомерКолонки).
Описание:
Действие возвращает значение из ячейки таблицы заданной её индексом и номером колонки. В базах данных созданных на платформе ПРОФТ-5 первая колонка обычно индексная и содержит порядковый номер строки, который является ее идентификатором. Этот индекс используется в других таблицах как ссылка на эту строку.
Свернуть
Синтаксис:
[ИДМодуля]:Свернуть(КолонкиСворачивания; КолонкиСуммирования).
Описание:
Действие сворачивает таблицу. Этот процесс заключается в объединении строк содержащих одинаковые значения в колонках перечисленных в параметре КолонкиСворачивания и суммирования значений в колонках перечисленных в параметре КолонкиСуммирования. Оба параметра представляют собой строки в кавычках, в которых перечислены номера колонок. Данные в неупомянутых колонках игнорируются.
Например:
Запрос:Свернуть("1;2";"3;4").
Закрыть
Синтаксис:
[ИДМодуля]:Закрыть.
Описание:
Действие закрывает таблицу: уничтожает все структуры и очищает оперативную память.
Пользователь
Синтаксис:
[ИДМодуля]:Пользователь(ИмяПользователя).
Описание:
Действие устанавливает для таблицы признак "Пользователь". Параметр ИмяПользователя должен быть не длиннее 256 символов. Признак нужен для дополнительной информации при выполнении действий Блокировать и Разблокировать, чтобы показать информацию какой пользователь заблокировал таблицу для чтения/записи.
Блокировать
Синтаксис:
[ИДМодуля]:Блокировать(НазваниеФайла).
Описание:
Действие блокирует файл указанный параметром НазваниеФайла не давая возможность другим пользователям производить чтение/запись. Вызывается перед действием Сохранить при работе в сетевых базах данных.
Разблокировать
Синтаксис:
[ИДМодуля]:Разблокировать.
Описание:
Действие снимает блокировку с таблицы модуля, который была ранее установлена действием Блокировать.