Admin: 1 revision imported

2021-02-07T06:53:40Z

1 revision imported

Admin at 11:18, 24 July 2020

2020-07-24T11:18:30Z

New page

{{infobox function
|name=Area
|object=[[Электронная таблица SFT|Электронная таблица]]
|caption=Доступ к свойствам ячеек
|type=1
|status=2
|db=0
|exception=Невозможно превратить в число
|visual=0}}
{{HeadLinks|
* [[Main_Page|Начальная страница]]
* [[Общее_описание_языка|Общее описание]]
* [[Объекты]]
* [[Электронная таблица SFT|Электронная таблица]]}}
Функция возвращает объект прямоугольной области таблицы. С объектом можно вызывать функции, типа [[Table.Area.Text|Text]] и пр. При изменении свойств области ячеек, состоящей из более чем одной ячейки, свойства будут изменяться одновременно для всех ячеек области.

== Синтаксис ==
<code>
{{Grey|Table.}}'''Area'''(''<Левый столбец области (INT)>'',''<Верхняя строка области (INT)>''{{Optional|,<Правый столбец области (INT)>,<Нижняя строка области (INT)>}}):''<Объект области таблицы (TABLE.AREA)>''
</code>

==== Аргументы ====
* <code>''<Левый столбец области (INT)>''</code> - Указывает на левый столбец области. Нумерация начинается с единицы.
* <code>''<Верхняя строка области (INT)>''</code> - Указывает на верхнюю строку области. Нумерация начинается с единицы.
* <code>''<Правый столбец области (INT)>''</code> - {{Optional}} Указывает на правый столбец области. Нумерация начинается с единицы. Если аргумент не задан, область будет состоять из одного столбца, заданного в первом аргументе.
* <code>''<Нижняя строка области (INT)>''</code> - {{Optional}} Указывает на нижнюю строку области. Нумерация начинается с единицы. Если аргумент не задан, область будет состоять из одной строки, заданной во втором аргументе.

==== Возвращаемое значение ====
Возвращает объект области таблицы.

== Примеры ==
<pre>
//Пример функции, вызываемой свободной таблицей при нажатии Enter или двойном клике по ячейке или объекту таблицы
Function OnDoubleClick(Таб)
If Таб.SelectionMode>1 Then
//Выделен объект, а не ячейка
if Таб.SelectedObjects().Count()<1 Then
Exit;
EndIf;
Obj:=Таб.SelectedObjects().Get(1);
//Получим значение объекта
Сп:=Obj.Value;
Else
//Получим значение ячейки под курсором
Сп:=Таб.Area(Таб.CurCol,Таб.CurLine,Таб.CurCol,Таб.CurLine).Value;
EndIf;
If TypeStr(Сп)<>"LIST" Then
Exit;
EndIf;
//Откроем модуль, закодированный в значении объекта или ячейки
If not isEmpty(Сп.GetByName("Module")) Then
Путь:=Сп.GetByName("Module");
Сп:=List.Create();
Сп.SetByName("Table",Таб);
Сп.SetByName("SimpleRootCall",1);
LoadModule(0,Путь,Сп,0,"Module","Form");
EndIf;
EndFunction
</pre>

← Older revision	Revision as of 06:53, 7 February 2021
(No difference)

Table.Area - Revision history

Admin: 1 revision imported

Admin at 11:18, 24 July 2020