Таблица

From SunFlurry wiki
Jump to: navigation, search
  Tab.png  Tab (Таблица)
Статус разработки: Реализован
Создание объекта: Create
Визуальный эквив.: Таблица значений

Объект таблица позволяет хранить большие объемы данных любого типа в виде таблиц, а также сортировать их, объединять таблицы, задавать определенные типы данных столбцам таблицы, хранить информацию о флажках или иконках. Таблицы представлены на формах таблицами значений, результаты запросов представлены таблицами, таблицы используются в разнообразных функциях и объектах и являются неотъемлемой частью системы. Функции работы с таблицами имеют ряд оптимизаций, доступных разработчикам.

Таблица имеет три внутренних указателя:

  • Текущая строка (CurLine) -- внутренний указатель, использующийся при изменении ячеек таблицы по наименованию столбца (к примеру, aTab.<Столбец>:=<Значение>). Указатель меняется при добавлении, удалении или сдвиге строк, а также при выборке строк таблицы с помощью функции Select, поиске значений и пр. Нумерация строк начинается с единицы.
  • Выбранная строка (SelectedLine) -- внутренний указатель, совпадающий с положением курсора (выделенной ячейки) внутри таблицы, когда она представлена на экране в виде элемента формы. Изменение указателя автоматически перемещает курсор. Использование указателя для невизуальных таблиц не запрещено. Нумерация строк начинается с единицы.
  • Выбранный столбец (SelectedColumn) -- внутренний указатель, совпадающий с положением курсора (выделенного столбца) внутри таблицы, когда она представлена на экране в виде элемента формы. Изменение указателя автоматически перемещает курсор. Использование указателя для невизуальных таблиц не запрещено. Нумерация столбцов начинается с единицы.

Атрибуты и функции

Идентификатор Статус Тип Визуальная Параметры Описание
[<Индекс столбца (INT,STRING)>], [<Индекс столбца (INT,STRING)>,<Индекс строки (INT)>] Реализована Атрибут Tab[<Индекс или наименование столбца (INT,STRING)>,<Индекс строки (INT)>]:<Значение> Использование синтаксиса массивов позволяет получить или изменить значение таблицы по индексу (аргументом является число) или наименованию (аргументом является строка) его столбца для текущей строки таблицы, если не задан второй аргумент, иначе для строки таблицы заданной индексом, указанным во втором аргументе.
<Имя столбца> Реализована Атрибут Tab.<Имя столбца>:<Значение ячейки> Получить значение таблицы, находящееся в столбце <Имя столбца> и строке с индексом CurLine
CurLine Реализована Атрибут Tab.CurLine:<Индекс текущей строки (INT)> Получить индекс текущей строки таблицы (первая строка=1). Текущая строка и выбранная пользователем строка визуального объекта, привязанного к таблице, могут иметь разные значения. Текущая строка используется в функциях выборки строк таблицы Select и пр.
SelectedLine Реализована Атрибут
Да
Tab.SelectedLine:<Индекс выбранной строки (INT)> Получить индекс выбранной строки визуального объекта (первая строка=1). Текущая строка и выбранная пользователем строка визуального объекта, привязанного к таблице, могут иметь разные значения.
SelectedColumn Реализована Атрибут
Да
Tab.SelectedColumn:<Индекс выбранного столбца (INT)> Получить индекс выбранного столбца визуального объекта (первый столбец=1). Скрытые в визуальной таблице столбцы также участвуют в подсчете индекса.
SelectedColumnName Реализована Атрибут
Да
Tab.SelectedColumnName:<Наименование выбранного столбца (STRING)> Получить наименование выбранного столбца визуального объекта, как оно было заданно в Студии. Наименование всегда хранится в верхнем регистре.
MultiSelection Реализована Атрибут
Да
Tab.MultiSelection:<Таблица с выбранными регионами (TAB)> Получить таблицу, описывающую все регионы, выделенные пользователем, для визуальных таблиц с возможностью выделения регионов. Таблица не будет содержать ни одной строки, если таблица не привязана к визуальному объекту, либо в объекте не выбрана ни одна строка.
IsEditorActive Реализована Атрибут
Да
Tab.IsEditorActive:<Статус редактора ячейки (INT)> Атрибут проверяет, активен ли редактор ячейки таблицы в данный момент.
Create Реализована Функция Tab.Create(<Список столбцов через запятую (STRING)>):<Новый объект (TAB)> Функция возвращает новый объект типа Таблица, создавая столбцы с заданными именами, если необходимо.
Column Реализована Функция Tab.Column(<Наименование или индекс столбца (INT,STRING)>):<Объект столбца таблицы (TAB)> Функция возвращает подчиненный объект типа столбец таблицы. Доступ к свойствам столбцов таким образом опасен для многопоточных объектов. Необходимо использовать функции LockObject и UnlockObject, когда объект используется в нескольких потоках.
Size, Lines Реализована Функция Tab.Size(<Новое количество строк (INT)>):<Текущее количество строк в таблице (INT)> Функция получает или/и изменяет количество строк в таблице.
Columns Реализована Функция Tab.Columns(<Новое количество столбцов (INT)>):<Текущее количество столбцов в таблице (INT)> Функция получает или/и изменяет количество столбцов в таблице.
AddColumn Реализована Функция Tab.AddColumn(<Наименование столбца (STRING)>,<Заголовок столбца (STRING)>,<Тип данных столбца (STRING)>,<Ширина столбца (INT)>,<Режим выравнивания столбца (INT)>,<Видимость столбца (INT)>) Функция добавляет столбец в таблицу, устанавливая его свойства, если необходимо. Если количество строк в таблице больше нуля, ячейки столбца заполняются пустым значением, либо принимают неинициализированное значение в соответствии с типом данных столбца, если последний задан.
InsertColumn Реализована Функция Tab.InsertColumn(<Индекс вставляемого столбца (INT)>,<Наименование столбца (STRING)>,<Заголовок столбца (STRING)>,<Тип данных столбца (STRING)>,<Ширина столбца (INT)>,<Режим выравнивания столбца (INT)>,<Видимость столбца (INT)>) Функция добавляет столбец в таблицу с указанным индексом, устанавливая его свойства, если необходимо. Если количество строк в таблице больше нуля, ячейки столбца заполняются пустым значением, либо принимают неинициализированное значение в соответствии с типом данных столбца, если последний задан.
RemoveColumn Реализована Функция Tab.RemoveColumn(<Наименование или индекс столбца (INT,STRING)>) Функция удаляет столбец с указанным индексом или наименованием из таблицы.
SetColumn Реализована Функция Tab.SetColumn(<Наименование или индекс столбца (INT,STRING)>,<Заголовок столбца (STRING)>,<Тип данных столбца (STRING)>,<Ширина столбца (INT)>,<Режим выравнивания столбца (INT)>,<Видимость столбца (INT)>) Функция изменяет свойства столбца с указанным индексом или наименование. Если новый тип данных столбца задан, все существующие ячейки таблицы в данном столбце будут приведены к новому типу данных.
GetColumnIndex Реализована Функция Tab.GetColumnIndex(<Наименование столбца (STRING)>):<Индекс столбца (INT)> Функция получает индекс столбца с заданным наименованием. Если столбец не существует, функция возвращает ноль.
GetColumnName Реализована Функция Tab.GetColumnName(<Индекс столбца (INT)>):<Наименование столбца таблицы (STRING)> Функция получает наименование столбца с заданным индексом. Наименования столбцов всегда хранятся в верхнем регистре.
NewLine Реализована Функция Tab.NewLine(<Индекс новой строки (INT)>) Функция добавляет в конец таблицы новую строку и помечает ее как текущую. Строка также может быть вставлена в таблицу по определенному индексу, если он задан.
AddLine Реализована Функция Tab.AddLine(<Наименования столбцов через запятую (STRING)>,<Значение столбца 1>,<Значение столбца 2>...) Функция добавляет в конец таблицы новую строку и помечает ее как текущую. Указанные в первом аргументе столбцы таблицы, в добавленной строке будут заполнены значениями, заданными последующими аргументами.
AddLineSorted Реализована Функция Tab.AddLineSorted(<Наименования столбцов сортировки через запятую (STRING)>,<Наименования столбцов добавления через запятую (STRING)>,<Значение столбца 1>,<Значение столбца 2>...) Функция добавляет новую строку и помечает ее как текущую. Указанные во втором аргументе столбцы таблицы, в добавленной строке будут заполнены значениями, заданными последующими аргументами. Строка вставляется в таблицу таким образом, чтобы не нарушить сортировку, заданную наименованиями столбцов первого аргумента.
InsertLine Реализована Функция Tab.InsertLine(<Индекс добавляемой строки (INT)>,<Наименования столбцов через запятую (STRING)>,<Значение столбца 1>,<Значение столбца 2>...) Функция вставляет строку в таблицу по указанному индексу и помечает ее как текущую. Указанные в первом аргументе столбцы таблицы, в добавленной строке будут заполнены значениями, заданными последующими аргументами.
CopyLine Реализована Функция Tab.CopyLine(<Индекс копируемой строки (INT)>,<Индекс новой строки (INT)>,<Количество добавляемых строк (INT)>=1) Функция добавляет новую строку по указанному во втором аргументе индексу (или в конец таблицы, если второй аргумент опущен) и заполняет ее значениями из строки, указанной в первом аргументе (или текущей строки, если первый аргумент опущен).
Remove Реализована Функция Tab.Remove(<Индекс удаляемой строки (INT)>,<Количество удаляемых строк (INT)>=1) Функция удаляет указанное количество строк (либо одну строку, если второй аргумент опущен), начиная с индекса, заданного первым аргументом.
ClearLines Реализована Функция Tab.ClearLines() Функция удаляет все строки из таблицы (при этом количество столбцов не изменяется).
Clear Реализована Функция Tab.Clear() Функция удаляет все строки и столбцы из таблицы.
Select Реализована Функция Tab.Select():<В таблице есть по крайней мере одна строка (INT)> Функция начинает выборку по строкам таблицы (ее действие аналогично фрагменту <Таблица>.CurLine:=0). Функция возвращает 1, если в выборке есть по крайней мере одна строка, иначе возвращается ноль. Функция используется в начале цикла по обходу всех строк таблицы.
Next Реализована Функция Tab.Next():<Найдена следующая строка (INT)> Функция перемещает указатель текущей строки на следующую строку и возвращает единицу, если следующая строка существует, иначе возвращает ноль. Действие функции аналогично фрагменту <Таблица>.CurLine:=?(<Таблица>.CurLine=<Таблица>.Size(),<Таблица>.CurLine,<Таблица>.CurLine+1). Функция используется внутри цикла по обходу всех строк таблицы.
Goto Реализована Функция Tab.Goto(<Индекс строки (INT)>) Функция перемещает указатель текущей строки на строку с указанным индексом. Действие функции аналогично фрагменту <Таблица>.CurLine:=<Индекс>
Move Реализована Функция Tab.Move(<Индекс перемещаемой строки (INT)>,<Расстояние перемещения (INT)>) Функция сдвигает строку с индексом, задаваемым первым аргументом, внутри таблицы на указанное количество строк. Расстояние сдвига может быть отрицательным числом. При положительном сдвиге, строка из конца таблицы переходит в ее начало, при отрицательном сдвиге строка с начала таблицы переходит в конец.
Set Реализована Функция Tab.Set(<Индекс строки (INT)>,<Наименование или индекс столбца (INT,STRING)>,<Устанавливаемое значение>) Функция устанавливает значение ячейки с наименованием или индексом столбца, заданным вторым аргументом, индекс строки ячейки задается первым аргументом или используется текущая строка, если первый аргумент не задан.
Get Реализована Функция Tab.Get(<Индекс строки (INT)>,<Наименование или индекс столбца (INT,STRING)>):<Значение ячейки таблицы> Функция получает значение ячейки с наименованием или индексом столбца, заданным вторым аргументом, индекс строки ячейки задается первым аргументом или используется текущая строка, если первый аргумент не задан.
Find Реализована Функция Tab.Find(<Значение поиска>,<Начальный индекс поиска, результирующий индекс (INT)>,<Наименование или индекс столбца поиска, индекс результирующего столбца (STRING,INT)>,<Таблица сортирована по столбцу поиска (INT)>):<Значение найдено 1 или 0 (INT)> Функция производит поиск значения в таблице, с возможным указанием начального индекса поиска, возможным указанием столбца поиска. Поиск может принимать во внимание факт того, что таблица сортирована по указанному столбцу по неубыванию, что может значительно ускорить нахождение значения. Если значение найдено, индекс строки или/и столбца, где оно было найдено, возвращается в переменных второго и третьего аргументов.
FindAndGoto Реализована Функция Tab.FindAndGoto(<Значение поиска>,<Начальный индекс поиска, результирующий индекс (INT)>,<Наименование или индекс столбца поиска, индекс результирующего столбца (STRING,INT)>,<Таблица сортирована по столбцу поиска (INT)>):<Значение найдено 1 или 0 (INT)> Функция производит поиск значения в таблице, с возможным указанием начального индекса поиска, возможным указанием столбца поиска. Поиск может принимать во внимание факт того, что таблица сортирована по указанному столбцу по неубыванию, что может значительно ускорить нахождение значения. Если значение найдено, индекс строки или/и столбца, где оно было найдено, возвращается в переменных второго и третьего аргументов, функция также автоматически изменяет индекс текущей строки на индекс строки найденного значения, текущая строка не изменяется, если значение не найдено.
FindAndGet Реализована Функция Tab.FindAndGet(<Наименование или индекс столбца значения результата (STRING,INT)>,<Значение поиска>,<Начальный индекс поиска, результирующий индекс (INT)>,<Наименование или индекс столбца поиска, индекс результирующего столбца (STRING,INT)>,<Таблица сортирована по столбцу поиска (INT)>):<Полученное значение или пустое значение> Функция производит поиск значения в таблице, с возможным указанием начального индекса поиска, возможным указанием столбца поиска. Поиск может принимать во внимание факт того, что таблица сортирована по указанному столбцу по неубыванию, что может значительно ускорить нахождение значения. Если значение найдено, индекс строки или/и столбца, где оно было найдено, возвращается в переменных третьего и четвертого аргументов. Функция возвращает значение в столбце, заданном первым аргументом, из строки, в которой было найдено значение поиска, либо возвращает пустое значение, если поиск не был завершен успешно.
FindInLine Реализована Функция Tab.FindInLine(<Значение поиска>,<Индекс строки поиска (INT)>,<Наименование или индекс начального столбца поиска, индекс результирующего столбца (STRING,INT)>):<Значение найдено 1 или 0 (INT)> Функция производит поиск значения в таблице в текущей строке или строке с заданным индексом, возможным указанием начального индекса столбца поиска. Если значение найдено, индекс столбца, где оно было найдено, возвращается в переменной третьего аргумента.
Locate Реализована Функция Tab.Locate(<Список наименований столбцов поиска через запятую (STRING)>,<Значение поиска столбца 1>,<Значение поиска столбца 2>...,<Таблица сортирована по столбцам поиска (INT)>):<Индекс найденной строки таблицы (INT)> Функция производит поиск заданного списком столбцов количества значений в таблице. Поиск всегда начинается с первой строки таблицы. Поиск может принимать во внимание факт того, что таблица сортирована по всем столбцам поиска по неубыванию, что может значительно ускорить нахождение значения. Если значение найдено, индекс строки где оно было найдено, возвращается в результате функции, иначе функция возвращает ноль.
LocateAndGoto Реализована Функция Tab.LocateAndGoto(<Список наименований столбцов поиска через запятую (STRING)>,<Значение поиска столбца 1>,<Значение поиска столбца 2>...,<Таблица сортирована по столбцам поиска (INT)>):<Индекс найденной строки таблицы (INT)> Функция производит поиск заданного списком столбцов количества значений в таблице. Поиск всегда начинается со строки таблицы, следующей за текущей строкой (чтобы поиск начинался с начала таблицы, можно выполнить операцию <Таблица>.CurLine:=0). Поиск может принимать во внимание факт того, что таблица сортирована по всем столбцам поиска по неубыванию, что может значительно ускорить нахождение значения. Если значение найдено, индекс строки где оно было найдено, возвращается в результате функции и обновляет текущую строку таблицы, иначе функция возвращает ноль.
Sort Реализована Функция Tab.Sort(<Наименование столбцов сортировки с суффиксами через запятую (STRING)>,<Алгоритм сортировки (INT)>=1) Функция выполняет сортировку строк таблицы по значениям указанных столбцов (направление сортировки может быть выбрано для каждого из столбцов в отдельности).
Sum Реализована Функция Tab.Sum(<Наименование или индекс столбца (INT,STRING)>,<Строки превращать в числа (INT)>=0,<Индекс начальной строки (INT)>=0,<Индекс конечной строки (INT)>=<Последняя строка таблицы>,<Округление при суммировании (INT)>=-1):<Результирующая сумма (NUMBER)> Функция находит сумму значений указанного столбца таблицы в указанном диапазоне строк таблицы. Значения, представленные строками, могут быть превращены в числа при сложении, если необходимо. Для исключения накопления неточности при сложении вещественных чисел, можно указать требуемое количество цифр после точки.
Compute Реализована Функция Tab.Compute(<Наименование или индекс столбца (INT,STRING)>,<Тип операции (STRING)>="SUM",<Строки превращать в числа (INT)>=0,<Индекс начальной строки (INT)>=0,<Индекс конечной строки (INT)>=<Последняя строка таблицы>,<Округление при суммировании или нахождении среднего (INT)>=-1):<Результат вычисления (NUMBER)> Функция выполняет одну из следующих операций на значениях указанного столбца таблицы в указанном диапазоне строк таблицы: сумма, минимум, максимум, среднее, количество значений. Значения, представленные строками, могут быть превращены в числа при сложении, если необходимо. Для исключения накопления неточности при сложении вещественных чисел, можно указать требуемое количество цифр после точки.
SumLine Реализована Функция Tab.SumLine(<Индекс строки суммирования (INT)>,<Строки превращать в числа (INT)>=0,<Округление при суммировании (INT)>=-1):<Результирующая сумма (NUMBER)> Функция находит сумму значений указанной строки таблицы. Значения, представленные строками, могут быть превращены в числа при сложении, если необходимо. Для исключения накопления неточности при сложении вещественных чисел, можно указать требуемое количество цифр после точки.
Fill Реализована Функция Tab.Fill(<Значение для заполнения>,<Индекс начальной строки (INT)>,<Индекс конечной строки (INT)>,<Индекс или наименование столбца (INT,STRING)>) Функция выполняет заполнение ячеек в указанном столбце таблицы для строк таблицы в указанном диапазоне указанным значением.
Copy Реализована Функция Tab.Copy():<Новая таблица (TAB)> Функция создает новый объект таблицы и заполняет ее столбцами, строками и значениями из текущей таблицы.
CopyTo Реализована Функция Tab.CopyTo(<Объект в который происходит копирование>,<Индекс начальной строки (INT)>,<Количество строк для копирования (INT)>,<Наименования столбцов копирования через запятую (STRING)>,<Наименования столбцов для фильтрации (STRING)>,<Фильтр столбца 1>,<Фильтр столбца 2>...) Функция позволяет произвести копирование ячеек указанного столбца из текущей таблицы в заданный список, либо ячеек, указанных столбцов из текущей таблицы в заданную таблицу. Строки для копирования могут быть ограничены определенным диапазоном и выбраны с помощью заданного фильтра.
Group Реализована Функция Tab.Group(<Наименования столбцов группировки через запятую (STRING)>,<Наименования столбцов для агрегации с типами операций (STRING)>,<Округление при суммировании (INT)>=-1) Функция производит группировку таблицы по указанным столбцам, строки, где совокупность значений столбцов группировки повторяется, будут удалены, при этом над столбцами агрегации для всех строк дублей и строки, оставшейся в таблице, будет произведена указанная операция агрегации. Столбцы, не перечисленные в столбцах группировки и столбцах агрегации, будут удалены. Для исключения накопления неточности при сложении вещественных чисел, можно указать требуемое количество цифр после точки при выполнении операций агрегации. После выполнения операции, в таблице сохраняется порядок следования строк, существовавший до операции.
InnerJoin, Join Реализована Функция Tab.InnerJoin(<Таблица, с которой объединяется текущая (TAB)>,<Наименования столбцов группировки через запятую (STRING)>,<Наименования столбцов для агрегации с типами операций (STRING)>,<Округление при суммировании (INT)>=-1) Функция оставляет в текущей таблице только строки, для которых присутствуют эквивалентные в указанной таблице (эквивалентной считается строка, для которой значения всех столбцов группировки в обеих таблицах будет одинаковым). При этом ячейки в столбцах агрегации будут представлять результат операции агрегации над оставленными строками исходной таблицы и всеми эквивалентными строками указанной таблицы. Для исключения накопления неточности при сложении вещественных чисел, можно указать требуемое количество цифр после точки при выполнении операций агрегации. После выполнения операции, в таблице сохраняется порядок следования строк, существовавший до операции.
LeftOuterJoin, LeftJoin Реализована Функция Tab.LeftOuterJoin(<Таблица, с которой объединяется текущая (TAB)>,<Наименования столбцов группировки через запятую (STRING)>,<Наименования столбцов для агрегации с типами операций (STRING)>,<Округление при суммировании (INT)>=-1) Функция выполняет агрегацию строк текущей таблицы с эквивалентными строками указанной таблицы (эквивалентной считается строка, для которой значения всех столбцов группировки в обеих таблицах будет одинаковым). При этом ячейки в столбцах агрегации будут представлять результат операции агрегации над строками исходной таблицы и всеми эквивалентными строками указанной таблицы. Для исключения накопления неточности при сложении вещественных чисел, можно указать требуемое количество цифр после точки при выполнении операций агрегации. После выполнения операции, в таблице сохраняется порядок следования строк, существовавший до операции.
FullOuterJoin, FullJoin Реализована Функция Tab.FullOuterJoin(<Таблица, с которой объединяется текущая (TAB)>,<Наименования столбцов группировки через запятую (STRING)>,<Наименования столбцов для агрегации с типами операций (STRING)>,<Округление при суммировании (INT)>=-1) Функция выполняет агрегацию строк текущей таблицы с эквивалентными строками указанной таблицы (эквивалентной считается строка, для которой значения всех столбцов группировки в обеих таблицах будет одинаковым), строки указанной таблицы, для которых нет эквивалента в текущей таблице, будут добавлены в последнюю с конца таблицы. При этом ячейки в столбцах агрегации будут представлять результат операции агрегации над строками исходной таблицы и всеми эквивалентными строками указанной таблицы. Для исключения накопления неточности при сложении вещественных чисел, можно указать требуемое количество цифр после точки при выполнении операций агрегации. После выполнения операции, в таблице сохраняется порядок следования строк, существовавший до операции.
Combine Реализована Функция Tab.Combine(<Таблица для выполнения операции (TAB)>,<Наименования или индексы столбцов для сравнения (STRING)>,<Тип операции (STRING)>="ADD",<Таблица сортирована по столбцам поиска (INT)>=0) Функция выполняет операцию объединения, заданную вторым аргументом, над текущей таблицей и таблицей, заданной первым аргументом. Результат операции сохраняется в текущей таблице. Аргегаьных операций не выполняется. Функцией удобно пользоваться, когда нет необходимости выполнять аргегатные операции, она проще и быстрее чем функции группы Join.
RemoveLocated Реализована Функция Tab.RemoveLocated(<Наименования столбцов поиска через запятую (STRING)>,<Значение столбца 1>,<Значение столбца 2>...,<Таблица сортирована по столбцам поиска (INT)>):<Удален по крайней мере один элемент (INT)> Функция производит поиск заданного списком столбцов количества значений в таблице. Строки, подходящие под фильтр поиска, будут удалены из таблицы. Поиск начинается со строки таблицы, следующей за текущей. Поиск может принимать во внимание факт того, что таблица сортирована по всем столбцам поиска по неубыванию, что может значительно ускорить операцию.
Compare Реализована Функция Tab.Compare(<Таблица для сравнения (TAB)>,<Столбцы для сравнения (STRING)>):<Сравниваемая таблица совпадает с текущей (INT)> Функция сравнивает текущую таблицу с заданной по указанным правилам, и возвращает 1, если таблицы эквивалентны.
RescaleColumns Реализована Функция
Да
Tab.RescaleColumns(<Процент использования ширины таблицы (INT)>=100) Функция выполняет изменение размеров видимых столбцов таблицы таким образом, чтобы они занимали всю ширину таблицы на экране, либо ее требуемую часть, если задан первый аргумент.
FixedLines Реализована Функция
Да
Tab.FixedLines(<Новое количество закрепленных строк (INT)>):<Текущее количество закрепленных строк (INT)> Функция производит закрепление заданного количества строк в верхней части визуального представления таблицы. Вне зависимости от положения курсора внутри таблицы, выбранные строки всегда будут показаны на экране.
FixedColumns Планируется Функция
Да
Tab.FixedColumns(<Новое количество закрепленных столбцов (INT)>):<Текущее количество закрепленных столбцов (INT)> Функция производит закрепление заданного количества столбцов в верхней части визуального представления таблицы. Вне зависимости от положения курсора внутри таблицы, выбранные столбцы всегда будут показаны на экране.
Check Реализована Функция
Да
Tab.Check(<Индекс строки галочки (INT)>,<Индекс или наименование столбца галочки (INT,STRING)>,<Новое состояние галочки (INT)>):<Текущее состояние галочки (INT)> Функция считывает или устанавливает значение галочки в указанном столбце таблицы. Функция может использоваться также для невизуальных таблиц.
Icon Реализована Функция
Да
Tab.Icon(<Индекс строки иконки (INT)>,<Индекс или наименование столбца иконки (INT,STRING)>,<Новый индекс иконки (INT)>):<Текущий индекс иконки (INT)> Функция считывает или устанавливает значение индекса иконки в указанном столбце таблицы. Функция может использоваться также для невизуальных таблиц.
BackgroundColor Реализована Функция
Да
Tab.BackgroundColor(<Индекс строки ячейки (INT)>,<Индекс или наименование столбца ячейки (INT,STRING)>,<Новый цвет фона ячейки (INT)>):<Текущий цвет фона ячейки (INT)> Функция считывает или устанавливает значение цвета фона ячейки в указанном столбце таблицы. Если столбец таблицы не указан цвет меняется для всей строки, если строка не указана для всех строк столбца или для всей таблицы, если не указана ни строка ни столбец. Функция может использоваться также для невизуальных таблиц.
FontColor Реализована Функция
Да
Tab.FontColor(<Индекс строки ячейки (INT)>,<Индекс или наименование столбца ячейки (INT,STRING)>,<Новый цвет текста ячейки (INT)>):<Текущий цвет текста ячейки (INT)> Функция считывает или устанавливает значение цвета текста в указанном столбце таблицы. Если столбец таблицы не указан цвет меняется для всей строки. Функция может использоваться также для невизуальных таблиц.
FontStyle Реализована Функция
Да
Tab.FontStyle(<Индекс строки ячейки (INT)>,<Индекс или наименование столбца ячейки (INT,STRING)>,<Новый стиль текста ячейки (INT)>):<Текущий стиль текста ячейки (INT)> Функция считывает или устанавливает значение стиля текста в указанном столбце таблицы. Если столбец таблицы не указан стиль меняется для всей строки. Функция может использоваться также для невизуальных таблиц.
StartEdit Планируется Функция
Да
Tab.StartEdit(<Индекс строки ячейки (INT)>,<Индекс или наименование столбца ячейки (INT,STRING)>):<Редактирование инициировано (INT)> Функция производит попытку запустить редактор ячейки таблицы для указанной ячейки таблицы.
FinishEdit Реализована Функция
Да
Tab.FinishEdit(<Режим окончания редактирования (INT)>,<Индекс выделенного столбца после окончания редактирования или ноль (INT,STRING)>) Функция инициирует окончание редактирования ячейки таблицы в указанном режиме.
Lock Реализована Функция
Да
Tab.Lock() Функция запрещает выполнения обновления визуальной таблицы при любом ее изменении до тех пор, пока не будет вызвана функция Unlock. Функция может использоваться перед большим количеством обновлений или заполнении большой таблицы для получения значительного ускорения операции. Функцию необходимо использовать совместно с конструкцией Try .. Finally для исключения вероятности появления нерабочей таблицы на форме.
Unlock Реализована Функция
Да
Tab.Unlock() Функция разрешает запрещенное ранее функцией Lock выполнения обновления визуальной таблицы при любом ее изменении. См. функцию Lock.
IsLocked Реализована Функция
Да
Tab.IsLocked():<Обновление запрещено (INT)> Функция проверяет, запрещено ли в данный момент обновление таблицы при ее изменении, запрет инициируется с помощью функции Lock.

Объект столбца таблицы

Подчиненный объект, ссылающийся на таблицу, используется для доступа к свойствам столбцов таблицы. Так как объект будет ссылаться на определенный столбец таблицы, существует вероятность удаления этого столбца в другом потоке до того, как программа закончит работу с объектом, это может создать ошибочную ситуацию. Чтобы обойти проблему, необходимо либо убедиться, что объект будет использоваться только в одном потоке, столбцы не будут удаляться в других потоках или использовать функции LockObject и UnlockObject (однако, их нельзя использовать с визуальными объектами). Функции, типа TypeStr будут возвращать такие же значения для этого объекта, как и для объекта основной таблицы.

Идентификатор Статус Тип Визуальная Параметры Описание
Name Реализована Атрибут Tab.Column.Name:<Имя столбца (STRING)> Атрибут позволяет получать или изменять имя столбца таблицы. Имена столбцов всегда хранятся в верхнем регистре.
Caption Реализована Атрибут
Да
Tab.Column.Caption:<Заголовок столбца (STRING)> Атрибут позволяет получать или изменять заголовок столбца таблицы.
DataType Реализована Атрибут Tab.Column.DataType:<Тип данных столбца (STRING)> Атрибут позволяет получать или изменять тип данных столбца таблицы. При изменении типа данных всех существующие ячейки таблицы в данном столбце, будут преобразованы в новый тип данных.
Width Реализована Атрибут
Да
Tab.Column.Width:<Ширина столбца (INT)> Атрибут позволяет получать или изменять ширину столбца таблицы в пикселях.
Align Реализована Атрибут
Да
Tab.Column.Align:<Режим выравнивания столбца (INT)> Атрибут позволяет получать или изменять режим выравнивания при выводе текста в столбце таблицы.
Mask Реализована Атрибут
Да
Tab.Column.Mask:<Шаблон редактирования столбца (STRING)> Атрибут позволяет получать или изменять шаблон маски редактирования ячеек столбца таблицы.
IsVisible Реализована Атрибут
Да
Tab.Column.IsVisible:<Видимость столбца (INT)> Атрибут позволяет получать состояние или изменять видимость столбца на экране.
Value Реализована Атрибут Tab.Column.Value:<Значение столбца в строке CurLine (INT)> Атрибут позволяет получать или изменять значение ячейки столбца в текущей строке таблицы.
ShowCheckboxes Реализована Атрибут
Да
Tab.Column.ShowCheckboxes:<Показывать галки в столбце (INT)> Атрибут позволяет получать состояние или изменять видимость галочек в столбце таблицы.
ShowIcons Реализована Атрибут
Да
Tab.Column.ShowIcons:<Показывать иконки в столбце (INT)> Атрибут позволяет получать состояние или изменять видимость иконок в столбце таблицы.
RedNegative Реализована Атрибут
Да
Tab.Column.RedNegative:<Выделять отрицательные числа красным в столбце (INT)> Атрибут позволяет получать состояние или изменять режим выделения красным ячеек таблицы, содержащих отрицательные числа в столбце таблицы.
Hint Реализована Атрибут
Да
Tab.Column.Hint:<Всплывающая подсказка для столбца (STRING)> Атрибут позволяет получать или изменять строку подсказки при наведении мышью на заголовок столбца таблицы.
IsEditable Реализована Атрибут
Да
Tab.Column.IsEditable:<Данные в столбце можно редактировать (INT)> Атрибут позволяет получать или изменять разрешение редактирования столбца таблицы.
IsSortable Реализована Атрибут
Да
Tab.Column.IsSortable:<Режим сортировки столбца (INT)> Атрибут позволяет получать или изменять разрешение визуальной сортировки столбца таблицы.
IsInEnterChain Реализована Атрибут
Да
Tab.Column.IsInEnterChain:<Столбец находить в Enter-цепочке (INT)> Атрибут позволяет получать или изменять режим участия ячеек столбца таблицы в визуальной цепочке ввода.
IsReadonly Реализована Атрибут
Да
Tab.Column.IsReadonly:<Столбец имеет атрибут только для чтения (INT)> Атрибут позволяет получать или изменять режим только для чтения при редактировании ячеек столбца таблицы.
MinWidth Реализована Атрибут
Да
Tab.Column.MinWidth:<Минимальная ширина столбца (INT)> Атрибут позволяет получать или изменять минимальную ширину столбца таблицы в пикселях.
MaxWidth Реализована Атрибут
Да
Tab.Column.MaxWidth:<Максимальная ширина столбца (INT)> Атрибут позволяет получать или изменять максимальную ширину столбца таблицы в пикселях.
Filter Реализована Атрибут
Да
Tab.Column.Filter:<Текущий визуальный фильтр столбца (STRING)> Атрибут позволяет получать текущий визуальный фильтр столбца таблицы (строку, введенную пользователем в этом столбце, для быстрого фильтрования элементов таблицы).
ForbidMassLoad Реализована Атрибут Tab.Column.ForbidMassLoad:<Запретить загрузку столбца функцией Massload (INT)> Атрибут позволяет получать или изменять режим запрета загрузки элементов ячеек столбца таблицы из базы данных при вызове функции MassLoadObjects.