Ячейка Excel

Ячейка Excel — компонент, используется для записи данных в указанную ячейку.

Внешний вид компонента

Режим проектировщика Режим оператора
Ячейка 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» и «Ячейка Excel» напрямую.

Примечание: ZETExcelDocument.осх если файл указаный у него в свойствах необнаружен он будет пытаться найти его в директории с ехе проекта. если и там его нету он выдаст сообщение что файл не обнаружен в таком то месте и если нажать «Ок» вызовется filedialog с выбором файла для открытия. Предварительно нужно создать и положить в выбранную папку файл с расширением с названием и расширением *.xlsx.

Программирование

При использовании компонента в сценарии и программируемом компоненте (скрипте) необходимо учитывать диапазоны значений подаваемых на входные ножки компонента, диапазоны значений свойств компонента, а также диапазоны значений параметров методов компонента.

Параметры:

Входные

  • Страница — указатель на страницу Excel, в ячейки которой будет производиться запись значений (любое число);
  • Данные — значения данных, которые нужно записать в указанную ячейку (любого типа).

Настраиваемые свойства:

Общие свойства (окружение)

Частные свойства (в скобках значение, установленное по умолчанию):

  • LONG Line — установка и чтение строки, в которую производится запись (число).
  • LONG Col — установка и чтение столбца, в который производится запись (число).

Пример

Проект в SCADA ZETView

Ячейка Excel - Пример

Данный компонент используется для создания различных проектов, в том числе таких как анализатор звукового спектра.

Результат работы проекта
Ячейка Excel - Результат работы проекта