Ячейка Excel — компонент, используется для записи данных в указанную ячейку.
Внешний вид компонента
Режим проектировщика | Режим оператора |
---|---|
Не имеет |
Параметры:
Входные
- Страница — указатель на страницу Excel, в ячейки которой будет производиться запись значений.
- Данные — данные любого типа, которые будут записаны в указанную ячейку.
Выходные
- Данные — выводятся данные, находящиеся в ячейке (текст).
- Данные — выводятся данные, находящиеся в ячейке (bool).
- Данные — выводятся данные, находящиеся в ячейке (float).
Настраиваемые свойства:
Частные свойства (в скобках значение, установленное по умолчанию):
- Line (1) — номер строки, в которую производиться запись.
- Col (1) — номер столбца, в которую производиться запись.
Данный компонент имеет некоторую особенность работы. Если, компонент получает одновременно 3 параметра: номер строки, номер столбца и значение которое необходимо записать, то независимо от количества изменений номера строки или номера столбца компонент не перейдет к нужной ячейке пока не получит значение на вход «Данные». То есть, если записать значение «3» в ячейку (1,2), а затем не меняя значение поменять номер ячейки, например (2,3), ничего не изменится. Но если, допустим подать на вход «Данные» значение 4, то компонент запишет в указанный excel-файл в ячейку (2,3), или в ту которая указана, значение 4.
Компонент «Ячейка Excel» специфичен и является составным блоком, а не самостоятельным компонентом. Для записи данных в Excel-файл, необходимо использовать данный компонент совместно с компонентами «Страница Excel» и «Документ Excel«. Соединять компоненты нужно в следующей последовательности:
Несмотря на то, что компоненты «Документ Excel«, «Страница Excel» и «Ячейка Excel» имеют входные и выходные контакты одного типа, с этих контактов поступают разнящиеся данные. С компонента «Документ Excel» поступает указатель на книгу, а с компонента «Страница Excel» указатель на страницу. Поэтому нельзя соединить «Документ Excel» и «Ячейка Excel» напрямую.
Примечание: ZETExcelDocument.осх если файл указаный у него в свойствах необнаружен он будет пытаться найти его в директории с ехе проекта. если и там его нету он выдаст сообщение что файл не обнаружен в таком то месте и если нажать «Ок» вызовется filedialog с выбором файла для открытия. Предварительно нужно создать и положить в выбранную папку файл с расширением с названием и расширением *.xlsx.
Программирование
При использовании компонента в сценарии и программируемом компоненте (скрипте) необходимо учитывать диапазоны значений подаваемых на входные ножки компонента, диапазоны значений свойств компонента, а также диапазоны значений параметров методов компонента.
Параметры:
Входные
- Страница — указатель на страницу Excel, в ячейки которой будет производиться запись значений (любое число);
- Данные — значения данных, которые нужно записать в указанную ячейку (любого типа).
Настраиваемые свойства:
Частные свойства (в скобках значение, установленное по умолчанию):
- LONG Line — установка и чтение строки, в которую производится запись (число).
- LONG Col — установка и чтение столбца, в который производится запись (число).
Пример
Проект в SCADA ZETView
Данный компонент используется для создания различных проектов, в том числе таких как анализатор звукового спектра.
Результат работы проекта