Tab.Check

From SunFlurry wiki
Jump to: navigation, search
  Check (Работа с галками)
Объект:Таблица
Статус разработки: Реализована
Тип:Функция
Обращение к БД:Нет
Исключения:Невозможно превратить в строку, число, неверные индексы
Визуальность:Да

Функция считывает или устанавливает значение галочки в указанном столбце таблицы. Галочка может иметь два состояния. Любая ячейка таблицы, даже в столбцах, где галочки не выводятся на экран, имеет атрибут галочки, функция также может использоваться для невизуальных таблиц. В отличие от списков, состояние галочки не может принимать любого значения. См. также ShowCheckboxes.

Синтаксис

Tab.Check(<Индекс строки галочки (INT)>,<Индекс или наименование столбца галочки (INT,STRING)>,<Новое состояние галочки (INT)>):<Текущее состояние галочки (INT)>

Аргументы

  • <Индекс строки галочки (INT)> - Индекс строки для чтения или изменения состояния галочки.
  • <Индекс или наименование столбца галочки (INT,STRING)> - Аргумент задает наименование столбца галочки, если он имеет тип строка, иначе задает номер столбца галочки, которую требуется прочитать или изменить.
  • <Новое состояние галочки (INT)> - (необязательный аргумент) Аргумент задает состояние галочки, если он опущен, состояние галочки не будет изменено. Возможны следующие состояния:
    • 0: галочка не установлена.
    • 1: галочка установлена.
    • 4: галочка для данной ячейки визуально не отображается.

Возвращаемое значение

Возвращает текущее состояние галочки ячейки заданной первым и вторым аргументами. Если галочка для ячейки не отображается, будет возвращено значение 4.

Примеры

//Создается и заполняется таблица значений
aTab:=Tab.Create("b1,b2,b3,b4");

aTab.AddLine("b1,b2,b3,b4",1,2,3,4);
aTab.AddLine("b1,b2,b3,b4",2,2,3,33);
aTab.AddLine("b1,b2,b3,b4",3,5,5,4);
aTab.AddLine("b1,b2,b3,b4",4,2,3,4);
aTab.AddLine("b1,b2,b3,b4",4,2,3,77);
aTab.AddLine("b1,b2,b3,b4",5,2,3,4);

//Функция установит галочку в ячейку b2 строки 1.
aTab.Check(1,"b2",1);

//По умолчанию новые ячейки содержат галочки с состоянием 0
//Функция выведет число 0.
Message(aTab.Check(1,"b1"));